Media, Film & Knowledge

RSS & Feed API API

The RSS & Feed API is a universal RSS, Atom and JSON Feed reader that returns clean JSON.

5 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary fetch endpoint returns a feed's metadata (title, link, description, language, updated, image, author) and its entries in a normalized shape regardless of source format, and you can discover a site's feeds, merge several feeds, search and batch. It is built for readers, content pipelines and monitoring tools that need normalized feed data without handling three feed formats. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/feed-gateway/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "url": "https://feeds.bbci.co.uk/news/world/rss.xml",
    "query": "a e i o u",
    "match": "any"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "feed-gateway",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 677.8,
    "record_count": 30,
    "bytes": 23101,
    "cache_hit": false,
    "ssrf_guarded": true,
    "scanned": 30,
    "feeds_total": 1
  },
  "data": {
    "items": [
      {
        "id": "https://www.bbc.co.uk/news/articles/clyxlm877p2o#0",
        "title": "Russian online retail warehouses hit by deadly Ukrainian strikes",
        "link": "https://www.bbc.co.uk/news/articles/clyxlm877p2o?at_medium=RSS&at_campaign=rss",
        "published": "[redacted-phone]T13:06:25Z",
        "updated": null,
        "author": null,
        "summary": "Drones targeted Wildberries facilities near Moscow and in Tambov. Ukraine's leader called them \"major logistics facilities\" supplying \"sanctioned components\".",
        "categories": [],
        "enclosures": [],
        "image": "https://ichef.bbci.co.uk/ace/standard/240/cpsprodpb/82d1/live/dae460c0-82a9-11f1-b976-0b9c15b0ccfc.jpg"
      },
      {
        "id": "https://www.bbc.co.uk/news/articles/cvg8w4dpjkwo#0",
        "title": "Many Ukrainian soldiers outraged over removal of defence minister, troops tell BBC",
        "link": "https://www.bbc.co.uk/news/articles/cvg8w4dpjkwo?at_medium=RSS&at_campaign=rss",
        "published": "[redacted-phone]T19:04:09Z",
        "updated": null,
        "author": null,
        "summary": "Protests erupted in Ukraine on Thursday after Mykhailo Fedorov's removal - and now soldiers are also criticising the move.",
        "categories": [],
        "enclosures": [],
        "image": "https://ichef.bbci.co.uk/ace/standard/240/cpsprodpb/0d83/live/2d7f0f[redacted-phone]f1-bee8-53ce494e1abc.jpg"
      },
      {
        "id": "https://www.bbc.co.uk/news/articles/cy748n8zx8ro#0",
        "title": "US strikes hit Iran for seventh consecutive night",
        "link": "https://www.bbc.co.uk/news/articles/cy748n8zx8ro?at_medium=RSS&at_campaign=rss",
        "published": "[redacted-phone]T16:56:34Z",
        "updated": null,
        "author": null,
        "summary": "Iran has retaliated against US allies in the region, with Kuwait reporting that a power and water plant had been hit.",
        "categories": [],
        "enclosures": [],
        "image": "https://ichef.bbci.co.uk/ace/standard/240/cpsprodpb/bd47/live/65f[redacted-phone]f1-b976-0b9c15b0ccfc.jpg"
      }
    ],
    "item_count": 30,
    "total_scanned": 30,
    "query": "a e i o u"
  }
}

Actions

What the RSS & Feed API API does

Action	Description	Concrete use case	Key params
fetch	Fetch ONE feed URL (RSS 2.0/0.9x, RSS 1.0/RDF, Atom, JSON-Feed 1.1 — auto-detected) and normalise it into one clean JSON schema. Broken XML, HTML entities, encoding mess and truncated feeds are repaired automatically (recovery step reported in meta).	Content platforms call fetch to fetch ONE feed URL (RSS 2.0/0.9x, RSS 1.0/RDF, Atom, JSON-Feed 1.1.	url, limit, sort_by, sort_dir, include_content, ...
discover	Find the feeds of ANY website: parses <link rel=alternate> tags + visible anchor hints, then probes common feed paths at BOTH the host root (/feed, /rss.xml, /atom.xml, /index.xml, …) AND under the given path (e.g. /r/programming/.rss). Every candidate is fetched and VERIFIED as a real parseable feed before being returned — so it works even on sites that don't declare a feed link-tag.	Research tools call discover to find the feeds of ANY website.	url, probe, limit
merge	Merge up to 10 feeds into ONE de-duplicated, date-sorted stream. Duplicates are detected on a canonical link key (tracking params stripped) falling back to guid/title. Each item carries its source_feed.	Community analysts call merge to get merge up to 10 feeds into ONE de-duplicated, date-sorted stream.	urls, limit, sort_dir, dedup, since, ...
search	Keyword-filter feed items (like RSSHub filter / Feedly search, but no account). Searches title/summary/author/categories (and content_html when include_content=true); multi-word queries match any or all terms; exclude= drops unwanted items.	Media monitors call search to get keyword-filter feed items (like RSSHub filter / Feedly search, but no account).	url, urls, query, exclude, fields, ...
batch	Fetch up to 20 feeds in ONE call (concurrent, fault-isolated): each feed returns independently with its own ok/error — one dead feed never fails the batch.	Content platforms call batch to fetch up to 20 feeds in ONE call (concurrent, fault-isolated).	urls, limit, include_content, sort_by, sort_dir

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/feed-gateway/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://feeds.bbci.co.uk/news/world/rss.xml","query":"a e i o u","match":"any"}'

import requests

r = requests.post(
    "https://api.reefapi.com/feed-gateway/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "url": "https://feeds.bbci.co.uk/news/world/rss.xml",
  "query": "a e i o u",
  "match": "any"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/feed-gateway/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "url": "https://feeds.bbci.co.uk/news/world/rss.xml",
  "query": "a e i o u",
  "match": "any"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.feed-gateway.search with {"url":"https://feeds.bbci.co.uk/news/world/rss.xml","query":"a e i o u","match":"any"}.

Use cases

Who uses this API and why

Feed readers call fetch to normalize RSS, Atom and JSON feeds into one schema.
Content pipelines use merge to combine many sources into a single sorted stream.
Monitoring tools use discover and batch to find and poll every feed for a set of sites.

FAQ

Questions developers ask before integrating

What is the RSS & Feed API API?

RSS & Feed API API is a ReefAPI endpoint group for rss & feed api It returns live JSON through POST requests under /feed-gateway/v1.

Is the RSS & Feed API API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. RSS & Feed API calls use the same shared credit balance as every other ReefAPI engine.

Do I need a RSS & Feed API login or account?

No login to RSS & Feed API is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the RSS & Feed API data?

The page example is captured from a live fetch call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the RSS & Feed API API use?

RSS & Feed API actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call RSS & Feed API from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call feed-gateway actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the RSS & Feed API API a RSS & Feed API scraper?

It is the managed alternative to a DIY RSS & Feed API scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same rss & feed api back as clean JSON.

Why does my RSS & Feed API scraper keep getting blocked?

Most RSS & Feed API scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / feed-gateway

RSS & Feed API

base /feed-gateway/v15 endpoints

post/feed-gateway/v1/fetch1 credit

Fetch ONE feed URL (RSS 2.0/0.9x, RSS 1.0/RDF, Atom, JSON-Feed 1.1 — auto-detected) and normalise it into one clean JSON schema. Broken XML, HTML entities, encoding mess and truncated feeds are repaired automatically (recovery step reported in meta).

Parameter		Allowed / range	Description
url	required	—	Feed URL (RSS/Atom/JSON-Feed). Bare hosts get https:// prefixed. Private/internal/metadata targets are SSRF-blocked.
limit = 50	optional	1–100	Max items returned (1-100, default 50). Out-of-range values are clamped, never rejected.
sort_by = feed_order	optional	feed_order · published · title · author	Item ordering. Competitors paywall sorting (rss2json needs an api_key for order_by) — here it is free.
sort_dir = desc	optional	desc · asc	Sort direction (applies when sort_by is not feed_order).
include_content = false	optional	—	Include the raw item HTML body as content_html (capped 30 KB). Off by default: summary is always returned as clean plain text.
since	optional	—	Only items published at/after this date (ISO 8601, e.g. 2026-06-01 or 2026-06-01T12:00:00Z).
until	optional	—	Only items published at/before this date (ISO 8601).

Try in playground →

post/feed-gateway/v1/discover1 credit

Find the feeds of ANY website: parses <link rel=alternate> tags + visible anchor hints, then probes common feed paths at BOTH the host root (/feed, /rss.xml, /atom.xml, /index.xml, …) AND under the given path (e.g. /r/programming/.rss). Every candidate is fetched and VERIFIED as a real parseable feed before being returned — so it works even on sites that don't declare a feed link-tag.

Parameter		Allowed / range	Description
url	required	—	Website URL (homepage or any page).
probe = true	optional	—	Also probe common feed paths (/feed, /rss.xml, /atom.xml, …) beyond the page's declared link tags.
limit = 10	optional	1–20	Max feeds returned (1-20, default 10).

Try in playground →

post/feed-gateway/v1/merge1 credit

Merge up to 10 feeds into ONE de-duplicated, date-sorted stream. Duplicates are detected on a canonical link key (tracking params stripped) falling back to guid/title. Each item carries its source_feed.

Parameter		Allowed / range	Description
urls	required	—	Feed URLs to merge (max 10). Each URL is independently SSRF-guarded and fetched concurrently; one bad feed never fails the whole call.
limit = 100	optional	1–200	Max items returned (1-200, default 100). Out-of-range values are clamped, never rejected.
sort_dir = desc	optional	desc · asc	Sort direction (applies when sort_by is not feed_order).
dedup = true	optional	—	Remove duplicate stories across feeds (default true).
since	optional	—	Only items published at/after this date (ISO 8601, e.g. 2026-06-01 or 2026-06-01T12:00:00Z).
until	optional	—	Only items published at/before this date (ISO 8601).
include_content = false	optional	—	Include the raw item HTML body as content_html (capped 30 KB). Off by default: summary is always returned as clean plain text.

Try in playground →

post/feed-gateway/v1/search1 credit

Keyword-filter feed items (like RSSHub filter / Feedly search, but no account). Searches title/summary/author/categories (and content_html when include_content=true); multi-word queries match any or all terms; exclude= drops unwanted items.

Parameter		Allowed / range	Description
url	optional	—	Single feed URL to search. (search needs url OR urls.)
urls	optional	—	Multiple feed URLs to search at once (max 10). Each URL is independently SSRF-guarded and fetched concurrently; one bad feed never fails the whole call.
query	optional	—	Keyword(s) to match, space-separated. Empty query + exclude acts as a pure exclusion filter. Case-insensitive substring match.
exclude	optional	—	Keyword(s) that DROP an item when present (RSSHub filter_out equivalent).
fields = title,summary	optional	title · summary · content · author · categories	Which item fields to match against (default title+summary).
match = any	optional	any · all	Multi-term combination mode.
limit = 50	optional	1–100	Max items returned (1-100, default 50). Out-of-range values are clamped, never rejected.
sort_by = feed_order	optional	feed_order · published · title · author	Item ordering. Competitors paywall sorting (rss2json needs an api_key for order_by) — here it is free.
sort_dir = desc	optional	desc · asc	Sort direction (applies when sort_by is not feed_order).
include_content = false	optional	—	Include the raw item HTML body as content_html (capped 30 KB). Off by default: summary is always returned as clean plain text.
since	optional	—	Only items published at/after this date (ISO 8601, e.g. 2026-06-01 or 2026-06-01T12:00:00Z).
until	optional	—	Only items published at/before this date (ISO 8601).

Try in playground →

post/feed-gateway/v1/batch1 credit

Fetch up to 20 feeds in ONE call (concurrent, fault-isolated): each feed returns independently with its own ok/error — one dead feed never fails the batch.

Parameter		Allowed / range	Description
urls	required	—	Feed URLs to fetch (max 20). Each URL is independently SSRF-guarded and fetched concurrently; one bad feed never fails the whole call.
limit = 20	optional	1–100	Max items returned (1-100, default 20). Out-of-range values are clamped, never rejected.
include_content = false	optional	—	Include the raw item HTML body as content_html (capped 30 KB). Off by default: summary is always returned as clean plain text.
sort_by = feed_order	optional	feed_order · published · title · author	Item ordering. Competitors paywall sorting (rss2json needs an api_key for order_by) — here it is free.
sort_dir = desc	optional	desc · asc	Sort direction (applies when sort_by is not feed_order).

Try in playground →

Example request · fetch

curl -X POST https://api.reefapi.com/feed-gateway/v1/fetch \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://feeds.bbci.co.uk/news/world/rss.xml","limit":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}