Skip to main content

Other Endpoints

Operations that could not be automatically categorized.

QueryRssItems1 pt

Fetch RSS feed items

Retrieves a list of items from an external RSS feed by URL. Use this query to pull syndicated content into your learning instance — for example, to display blog posts, news articles, or announcements sourced from an RSS feed. The API fetches and parses the remote feed at request time, returning each item's metadata including title, author, description, categories, image, link, and publication date.

Arguments

NameTypeDescription
feedUrlString!The fully qualified URL of the RSS feed to fetch and parse. Must be a publicly accessible RSS or Atom feed endpoint.

Returns

FieldTypeDescription
idID!A unique identifier for the RSS item, typically the item's URL or GUID from the feed.
categories[String!]!An array of category labels associated with the RSS item as defined in the feed.
titleStringThe headline or title of the RSS item.
linkStringThe URL linking to the full content of the RSS item.
authorStringThe name of the author of the RSS item.
descriptionStringA summary or excerpt of the RSS item's content.
imageUrlStringThe URL of the thumbnail or feature image associated with the RSS item.
imageAltTitleStringThe alt text for the item's image, used for accessibility.
dateDateThe publication date of the RSS item.

Example

query RssItems {
  RssItems(feedUrl: "https://example.com/feed.rss") {
    id
    title
    author
    description
    link
    categories
    imageUrl
    imageAltTitle
    date
  }
}

Example Response

{
  "data": {
    "RssItems": [
      {
        "id": "https://example.com/posts/intro-to-graphql",
        "title": "Introduction to GraphQL",
        "author": "Jane Smith",
        "description": "A beginner-friendly overview of GraphQL and how it compares to REST APIs.",
        "link": "https://example.com/posts/intro-to-graphql",
        "categories": [
          "Technology",
          "APIs"
        ],
        "imageUrl": "https://example.com/images/graphql-intro.jpg",
        "imageAltTitle": "GraphQL logo on a blue background",
        "date": "2024-03-15"
      },
      {
        "id": "https://example.com/posts/learning-best-practices",
        "title": "eLearning Best Practices for 2024",
        "author": "John Doe",
        "description": "Explore the top trends and strategies shaping online learning this year.",
        "link": "https://example.com/posts/learning-best-practices",
        "categories": [
          "eLearning",
          "Education"
        ],
        "imageUrl": "https://example.com/images/elearning-2024.jpg",
        "imageAltTitle": "Person learning on a laptop",
        "date": "2024-02-28"
      }
    ]
  },
  "id": "abc-123",
  "categories": [
    "example"
  ],
  "title": "example",
  "link": "example",
  "author": "example",
  "description": "example",
  "imageUrl": "example",
  "imageAltTitle": "example",
  "date": "2026-01-01T00:00:00Z"
}

The feed is fetched from the remote URL at request time. Availability and response time depend on the external feed's uptime and latency. Ensure the feed URL is publicly accessible from the server.