RSS · Example Payload

Feed Autodiscovery Example

How an HTML page advertises the location of its RSS, Atom, and JSON Feed documents via elements in the document head. Feed readers, browsers, and crawlers scan the HEAD of a page for these elements to discover feeds without requiring the user to know the exact feed URL.

SyndicationRSSAtomJSON FeedOPMLContentXMLSpecificationStandard

Feed Autodiscovery Example is an example object payload from RSS, with 6 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

descriptionhtmlPatternexampleswellKnownfullPageExample_metadata

Example Payload

{
  "description": "How an HTML page advertises the location of its RSS, Atom, and JSON Feed documents via <link rel='alternate'> elements in the document head. Feed readers, browsers, and crawlers scan the HEAD of a page for these elements to discover feeds without requiring the user to know the exact feed URL.",
  "htmlPattern": "<link rel=\"alternate\" type=\"<media-type>\" title=\"<title>\" href=\"<feed-url>\">",
  "examples": [
    {
      "format": "RSS 2.0",
      "mediaType": "application/rss+xml",
      "html": "<link rel=\"alternate\" type=\"application/rss+xml\" title=\"API Evangelist RSS\" href=\"https://apievangelist.com/feed.xml\">"
    },
    {
      "format": "Atom 1.0",
      "mediaType": "application/atom+xml",
      "html": "<link rel=\"alternate\" type=\"application/atom+xml\" title=\"API Evangelist Atom\" href=\"https://apievangelist.com/atom.xml\">"
    },
    {
      "format": "JSON Feed 1.1",
      "mediaType": "application/feed+json",
      "html": "<link rel=\"alternate\" type=\"application/feed+json\" title=\"API Evangelist JSON Feed\" href=\"https://apievangelist.com/feed.json\">"
    },
    {
      "format": "OPML Subscription List",
      "mediaType": "text/x-opml",
      "html": "<link rel=\"alternate\" type=\"text/x-opml\" title=\"My Subscriptions\" href=\"https://apievangelist.com/subscriptions.opml\">"
    }
  ],
  "wellKnown": {
    "path": "/.well-known/feeds",
    "status": "informal",
    "description": "Some sites publish an index of feeds at /.well-known/feeds as an HTTP-level alternative to HTML autodiscovery. This is not yet a registered well-known URI in the IETF registry; HTML autodiscovery and OPML subscription lists remain the interoperable mechanisms."
  },
  "fullPageExample": {
    "title": "Example HEAD with multi-format autodiscovery",
    "html": "<!doctype html>\n<html>\n  <head>\n    <title>API Evangelist</title>\n    <link rel=\"alternate\" type=\"application/rss+xml\" title=\"RSS\" href=\"https://apievangelist.com/feed.xml\">\n    <link rel=\"alternate\" type=\"application/atom+xml\" title=\"Atom\" href=\"https://apievangelist.com/atom.xml\">\n    <link rel=\"alternate\" type=\"application/feed+json\" title=\"JSON Feed\" href=\"https://apievangelist.com/feed.json\">\n  </head>\n  <body>...</body>\n</html>"
  },
  "_metadata": {
    "source": "https://www.rssboard.org/rss-autodiscovery",
    "anchoringQuote": "The rel attribute must have a value of 'alternate', a keyword that indicates the link is an alternate version of the site's main content."
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/feed-autodiscovery-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.