RSS

aid: rss
name: RSS
description: RSS (Really Simple Syndication) is the canonical XML feed format family for publishing and subscribing to streams
  of frequently updated content — blogs, news, podcasts, and other periodic resources. The RSS family in this index covers
  RSS 2.0 (stewarded by the RSS Advisory Board), Atom 1.0 (RFC 4287), JSON Feed 1.1, the RSS Best Practices Profile, OPML
  2.0 for feed subscription lists, and HTML autodiscovery conventions used by feed readers to locate feeds from a site's homepage.
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Syndication
- RSS
- Atom
- JSON Feed
- OPML
- Content
- XML
- Specification
- Standard
url: https://raw.githubusercontent.com/api-evangelist/rss/refs/heads/main/apis.yml
created: '2025-01-01'
modified: '2026-05-23'
specificationVersion: '0.19'
apis:
- aid: rss:rss-2-0
  name: RSS 2.0
  description: RSS 2.0 is the dominant XML-based syndication format, stewarded by the RSS Advisory Board. A feed consists
    of a root <rss version="2.0"> element wrapping a single <channel> with required title, link, and description, plus a sequence
    of <item> elements describing each piece of syndicated content. The spec is intentionally frozen — extensions happen through
    XML namespaces rather than core changes.
  humanURL: https://www.rssboard.org/rss-specification
  tags:
  - RSS
  - Syndication
  - XML
  - Specification
  properties:
  - type: Documentation
    url: https://www.rssboard.org/rss-specification
  - type: BestPractices
    url: https://www.rssboard.org/rss-profile
  - type: Validator
    url: https://www.rssboard.org/rss-validator/
  - type: Autodiscovery
    url: https://www.rssboard.org/rss-autodiscovery
  - type: MediaType
    url: https://www.iana.org/assignments/media-types/application/rss+xml
  - type: JSONSchema
    url: json-schema/rss-channel-schema.json
  - type: JSONSchema
    url: json-schema/rss-item-schema.json
  - type: JSONStructure
    url: json-structure/rss-channel-structure.json
  - type: Examples
    url: examples/rss-channel-example.json
  - type: Examples
    url: examples/rss-item-example.json
- aid: rss:atom-1-0
  name: Atom 1.0
  description: Atom 1.0, defined by IETF RFC 4287, is an XML-based syndication format developed as a more rigorously specified
    alternative to RSS 2.0. An Atom feed (atom:feed) contains required atom:id, atom:title, atom:updated, and atom:author
    elements plus a sequence of atom:entry items each with their own id, title, updated, and content or summary. Atom uses
    the namespace http://www.w3.org/2005/Atom and the application/atom+xml media type.
  humanURL: https://datatracker.ietf.org/doc/html/rfc4287
  tags:
  - Atom
  - Syndication
  - IETF
  - XML
  - Specification
  properties:
  - type: Specification
    url: https://datatracker.ietf.org/doc/html/rfc4287
  - type: Namespace
    url: http://www.w3.org/2005/Atom
  - type: MediaType
    url: https://www.iana.org/assignments/media-types/application/atom+xml
  - type: JSONSchema
    url: json-schema/atom-feed-schema.json
  - type: JSONSchema
    url: json-schema/atom-entry-schema.json
  - type: Examples
    url: examples/atom-feed-example.json
- aid: rss:json-feed-1-1
  name: JSON Feed 1.1
  description: JSON Feed 1.1 is a JSON-based syndication format created by Brent Simmons and Manton Reece as a developer-friendly
    alternative to RSS and Atom. A JSON Feed has top-level version, title, and items, with each item carrying a required id
    and at least one of content_html or content_text. JSON Feed is served with the application/feed+json media type.
  humanURL: https://www.jsonfeed.org/version/1.1/
  tags:
  - JSON Feed
  - Syndication
  - JSON
  - Specification
  properties:
  - type: Specification
    url: https://www.jsonfeed.org/version/1.1/
  - type: MediaType
    url: application/feed+json
  - type: JSONSchema
    url: json-schema/json-feed-schema.json
  - type: JSONSchema
    url: json-schema/json-feed-item-schema.json
  - type: Examples
    url: examples/json-feed-example.json
- aid: rss:rss-best-practices-profile
  name: RSS Best Practices Profile
  description: The RSS Best Practices Profile is the RSS Advisory Board's normative guidance on producing RSS feeds that interoperate
    cleanly across the diverse population of feed readers. It covers character data, date formats, email addresses, URLs,
    element-by-element recommendations, and common namespace extensions including how to use guid, pubDate, and enclosure
    to avoid known interoperability problems.
  humanURL: https://www.rssboard.org/rss-profile
  tags:
  - RSS
  - Best Practices
  - Profile
  - Interoperability
  properties:
  - type: Documentation
    url: https://www.rssboard.org/rss-profile
  - type: Vocabulary
    url: vocabulary/rss-vocabulary.yml
- aid: rss:opml-2-0
  name: OPML 2.0
  description: OPML (Outline Processor Markup Language) 2.0 is an XML format for outlines, most commonly used to exchange
    lists of RSS/Atom feed subscriptions between feed readers. A subscription list OPML file has a body containing outline
    elements with type="rss", text, xmlUrl (the feed URL), and htmlUrl (the human-readable site URL). OPML is the de facto
    portable format for feed subscription import/export.
  humanURL: http://opml.org/spec2.opml
  tags:
  - OPML
  - Outline
  - Subscription
  - Syndication
  - XML
  properties:
  - type: Specification
    url: http://opml.org/spec2.opml
  - type: JSONSchema
    url: json-schema/opml-subscription-list-schema.json
  - type: Examples
    url: examples/opml-subscription-list-example.json
- aid: rss:feed-autodiscovery
  name: Feed Autodiscovery
  description: Feed autodiscovery is the HTML convention by which a web page advertises the location of its RSS, Atom, or
    JSON Feed using a <link rel="alternate" type="application/rss+xml" href="..."> element in the document head. Feed readers,
    browsers, and crawlers look for this element to discover feeds from a homepage URL alone, without requiring the user to
    know the exact feed path. The same pattern is used with application/atom+xml and application/feed+json types.
  humanURL: https://www.rssboard.org/rss-autodiscovery
  tags:
  - Autodiscovery
  - HTML
  - Syndication
  - Discovery
  properties:
  - type: Documentation
    url: https://www.rssboard.org/rss-autodiscovery
  - type: Examples
    url: examples/feed-autodiscovery-example.json
common:
- type: DomainSecurity
  url: security/rss-domain-security.yml
- type: Website
  url: https://www.rssboard.org/
- type: Documentation
  url: https://www.rssboard.org/rss-specification
- type: BestPractices
  url: https://www.rssboard.org/rss-profile
- type: Validator
  url: https://www.rssboard.org/rss-validator/
- type: Blog
  url: https://www.rssboard.org/news
- type: AtomSpecification
  url: https://datatracker.ietf.org/doc/html/rfc4287
- type: JSONFeedSpecification
  url: https://www.jsonfeed.org/version/1.1/
- type: OPMLSpecification
  url: http://opml.org/spec2.opml
- type: JSONLDContext
  url: json-ld/rss-context.jsonld
- type: Vocabulary
  url: vocabulary/rss-vocabulary.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com