RSS Feed Reader
RSS Feed Reader reads any number of RSS 2.0, RDF, Atom or JSON Feed URLs and returns one JSON row per item with itemTitle, link, guid, publishedAt and updatedAt in ISO 8601 UTC, author, summary, categories, imageUrl, enclosures and feedFormat. It costs $0.0005 per item, which is $0.50 per 1,000 items. It adds only-new mode for scheduled runs and archive history for 350+ news feeds, and runs from the Console, API or MCP.
from $0.0005 per feed item, $0.5 per 1,000 · Updated Nov 2026, version 0.1.3
Key facts
- Price
- from $0.0005 per feed item, $0.5 per 1,000
- Pricing model
- Pay per event
- Output
- JSON, CSV, Excel, XML, RSS via Apify datasets
- Access
- Apify Console, REST API, Python and JS clients, MCP tool rss_feed_reader
- Version
- Updated Nov 2026, version 0.1.3
- Usage
- 100.0% successful runs (30 days)
- Actor
subimpact/rss-feed-reader
Who it is for
- Developers replacing brittle feed parsing code
- News monitoring teams tracking publisher feeds on a schedule
- Marketers watching brand and keyword mentions in trade feeds
- AI teams feeding fresh article summaries into a pipeline
Use cases
Poll feeds for new items only
Set onlyNew to true on a scheduled task and each run returns just the items that appeared since the last one. The Actor keeps a record per feed in the key-value store named by stateStoreName, holding the item keys and canonical links it has delivered, and writes that record only after the rows are pushed, so a failed run does not swallow items.
Recover items a feed dropped
Many publisher feeds only carry 10 or 20 items, so a daily poll can miss a busy day. Set includeArchive to true and the Actor merges items from its news index of 350+ publisher feeds with the live rows, flagged with fromArchive. De-duplication by identity keeps one row per item, and the date and keyword filters still apply.
One schema across mixed formats
Point feedUrls at an RSS 2.0 feed, an Atom feed and a JSON Feed at once. Every row uses the same field names whatever the source format, and feedFormat tells you which one it came from. publishedAt and updatedAt are always ISO 8601 UTC, summaries have HTML stripped, and ISO-8859-1 or windows-1252 charsets are decoded correctly.
Keyword and date filtered monitoring
Set keywords to keep only items whose title or summary contains a term, and publishedAfter or publishedBefore to bound the window with ISO dates. Items with no usable date are left out while a date filter is set, because they cannot be proven to be in range. That combination turns 500 feeds into a short list of relevant rows each morning.
Discover a site's feed
Not every site publishes its feed URL. Pass the ordinary page and the Actor follows the link rel=alternate feed the page advertises, then reports the discovered URL in feedUrl while inputUrl keeps what you supplied. Pages without any feed link are reported as a feed error in the run summary rather than as silent empty rows.
Output fields
| Field | Type | Description |
|---|---|---|
itemTitle | string/null | Headline of the feed item |
link | string/null | Item URL from the feed, resolved to an absolute URL |
guid | string/null | The feed's own item identifier (RSS guid, Atom id, JSON Feed id), when present |
publishedAt | string/null | Publication time normalised to ISO 8601 UTC; null when the feed carries no usable date |
updatedAt | string/null | Last update time normalised to ISO 8601 UTC, when the feed carries one |
author | string/null | Byline from the feed (dc:creator, Atom author or JSON Feed authors), when present |
summary | string/null | Plain-text summary with HTML stripped, max 1,000 characters |
contentHtml | string/null | Full item content HTML (content:encoded, Atom content or JSON Feed content_html), truncated to 20,000 characters. Null unless includeContent is on |
categories | array | All categories, tags or labels the feed attached to the item |
imageUrl | string/null | Lead image: image enclosure, media:thumbnail, media:content or the first img in the item content |
enclosures | array | Media attachments declared by the feed (podcast audio, images, video) |
feedTitle | string/null | Title of the feed the item came from |
Show all 18 fields
| Field | Type | Description |
|---|---|---|
feedUrl | string | URL the feed was actually read from, after redirects and HTML feed discovery |
inputUrl | string | The URL you supplied for this feed (may be a site page that links to a feed) |
feedFormat | string/null | rss2, rss1, atom or jsonfeed. Null only for archive rows when the live feed could not be read |
fromArchive | boolean | True when the item came from the news archive index (includeArchive) rather than the live feed |
itemKey | string | Stable identity used by only-new mode: guid/id if present, else link, else sha1(title + published) |
scrapedAt | string | When this run read the item, ISO 8601 UTC |
Sample output
From one of our own test runs on 20 Nov 2026, trimmed. Personal data is redacted.
2 rows, first 3 shown
[
{
"itemTitle": "UK and EU to agree youth mobility scheme, BBC understands",
"link": "https://www.bbc.co.uk/news/articles/c623j4kpg94go?at_medium=RSS&at_campaign=rss",
"guid": "https://www.bbc.co.uk/news/articles/c623j4kpg94go#1",
"publishedAt": "2026-11-20T02:40:49.000Z",
"updatedAt": null,
"author": null,
"summary": "The scheme is expected to be approved at Friday's UK-EU summit, with new deals on food trade and carbon emissions also on the table.",
"categories": [],
"imageUrl": "https://ichef.bbci.co.uk/ace/standard/240/cpsprodpb/30e0/live/a012a6c0-e48b-11f1-99b6-a35a62fa4264.jpg",
"enclosures": [],
"feedTitle": "BBC News",
"feedUrl": "https://feeds.bbci.co.uk/news/rss.xml",
"inputUrl": "https://feeds.bbci.co.uk/news/rss.xml",
"feedFormat": "rss2",
"fromArchive": false,
"itemKey": "https://www.bbc.co.uk/news/articles/c623j4kpg94go#1",
"scrapedAt": "2026-11-20T02:44:43.069Z"
},
{
"itemTitle": "Does our ethnicity change how we experience dying?",
"link": "https://www.bbc.co.uk/news/articles/cv7028g0j3yxo?at_medium=RSS&at_campaign=rss",
"guid": "https://www.bbc.co.uk/news/articles/cv7028g0j3yxo#2",
"publishedAt": "2026-11-20T01:29:43.000Z",
"updatedAt": null,
"author": null,
"summary": "Death is the one certainty we all share - but could our ethnicity change how we go through it?",
"categories": [],
"imageUrl": "https://ichef.bbci.co.uk/ace/standard/240/cpsprodpb/b2fd/live/eeca2fc0-e2b2-11f1-8226-87dfa5049e9a.jpg",
"enclosures": [],
"feedTitle": "BBC News",
"feedUrl": "https://feeds.bbci.co.uk/news/rss.xml",
"inputUrl": "https://feeds.bbci.co.uk/news/rss.xml",
"feedFormat": "rss2",
"fromArchive": false,
"itemKey": "https://www.bbc.co.uk/news/articles/cv7028g0j3yxo#2",
"scrapedAt": "2026-11-20T02:44:43.159Z"
}
]Input
| Field | Type | Required | Description | Default |
|---|---|---|---|---|
feedUrls | array | No | RSS, Atom or JSON Feed URLs. A normal web page also works: the actor follows the feed it advertises (link rel=alternate). Leave empty to read the BBC News feed, so you can try the actor in one click. | - |
maxItemsPerFeed | integer | No | Newest items kept per feed, after the date and keyword filters (1-1000). A feed's items are always returned newest first. | 50 |
maxTotalItems | integer | No | Global cap for the whole run (1-100000). Once it is reached no more rows are pushed. You pay per delivered item, so the default run stays under $0.05. | 100 |
publishedAfter | string | No | Keep items published on or after this date. ISO date (2026-10-01) or datetime (2026-10-01T09:00:00Z). Items with no date are dropped while a date filter is set. | - |
publishedBefore | string | No | Keep items published on or before this date (a bare date covers the whole day). ISO date or datetime. | - |
keywords | array | No | Keep only items whose title or summary contains ANY of these words, case-insensitive. Leave empty for every item. | [] |
includeContent | boolean | No | On: every row also carries contentHtml (content:encoded / Atom content / content_html), truncated to 20,000 characters. Off (default): only the plain-text summary (max 1,000 characters) is returned. | false |
onlyNew | boolean | No | For scheduled runs: remembers, per feed, which items were already delivered. A named key-value store in your account keeps the item keys, and it is written only after a feed's rows are pushed. The first run delivers everything and rememb... | false |
stateStoreName | string | No | Named key-value store that holds the only-new state (letters, numbers and dashes, 1-63 characters). Use a different name per task if you want independent tracking. Not used when onlyNew is off. | rss-feed-reader-state |
includeArchive | boolean | No | On: also return older items the live feed no longer carries, for feeds covered by our news index (350+ news publisher feeds). Archive rows have fromArchive = true. If the archive is unavailable the run still returns live items and adds a... | false |
maxConcurrency | integer | No | How many feeds are read at the same time (1-20). Lower it for slow or rate-limited servers. | 5 |
proxyConfiguration | object | No | No proxy by default, which is what most feeds need. Enable Apify Proxy only if a feed blocks your server IP. | {"useApifyProxy":false} |
Example input
{
"feedUrls": [
"https://feeds.bbci.co.uk/news/rss.xml",
"https://hnrss.org/frontpage"
],
"maxItemsPerFeed": 50,
"maxTotalItems": 100,
"maxConcurrency": 5
}Pricing
| Event | What it means | Price | Lowest tier |
|---|---|---|---|
item | One feed item delivered to the dataset. | $0.0005 | $0.0005 |
apify-actor-start | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). | $0.00005 | $0.00005 |
$0.5 for 1,000 feed item units at the listed price.
Prices from the Apify Store on 20 November 2026. Apify shows the final price before each run.
How it compares with other Apify actors
Price per 1,000 items at Apify Store list prices. Every row is a live listing on the Store, read on 20 Nov 2026, so a buyer can check each number at the source.
| Actor | Price per 1,000 items (Free plan) | Higher plans (Gold) | Start fee per run | Platform usage | Users | Rating | Last build |
|---|---|---|---|---|---|---|---|
| RSS Feed Reader: RSS, Atom & JSON Feed to JSON This API | $0.5 | $0.5 | $0.00005 | Included | 2 | No reviews yet | 18 Nov 2026 |
| RSS Feed Reader: RSS, Atom & JSON Feeds to JSON | $1.15 | $0.6 | $0.035 | Included | 208 | No reviews yet | 16 Nov 2026 |
| RSS & Atom Feed Reader - Monitor Any Feed at Scale | Bills one event per feed parsed plus a small start event, rather than one per item. | None | Included | 138 | No reviews yet | 14 Nov 2026 | |
| RSS Feed Scraper - RSS & Atom to JSON | $8.00 | $8.00 | None | Included | 106 | 5.0 (1 review) | 8 Nov 2026 |
| RSS to JSON API | RSS, Atom & Podcast Feeds | $2.00 | $2.00 | $0.00005 | Included | 23 | No reviews yet | 15 Aug 2026 |
Where RSS Feed Reader: RSS, Atom & JSON Feeds to JSON is stronger
Where RSS Feed Reader: RSS, Atom & JSON Feeds to JSON is stronger
- Larger user base and more monthly runs than the other feed readers here
- Paste a website URL and it finds the feed for you
- Rows record where a discovered feed was found
Where this API is stronger
- Only new mode with stored state, so scheduled runs skip items already seen
- Archive history adds older items when you need a backfill
- Rows carry a category list, enclosure list and full content HTML
Where RSS & Atom Feed Reader - Monitor Any Feed at Scale is stronger
Where RSS & Atom Feed Reader - Monitor Any Feed at Scale is stronger
- Wide output with podcast episode fields such as season and episode type
- Feed level fields include language, generator and update time
- Returns item counts plus the latest and oldest item dates per feed
Where this API is stronger
- Charged per item, so a large feed costs in proportion to what you receive
- Only new mode keeps scheduled runs from repeating items
- Date range and keyword filters apply to individual items
Where RSS Feed Scraper - RSS & Atom to JSON is stronger
Where RSS Feed Scraper - RSS & Atom to JSON is stronger
- Finds a feed from a plain website URL
- Keyword and date filters plus optional error rows for debugging
- Media content and thumbnail fields on each item
Where this API is stronger
- Only new mode with stored state for repeat scheduled runs
- Archive history across many news feeds for older items
- Item rows carry a category list, enclosure list and content HTML
Where RSS to JSON API | RSS, Atom & Podcast Feeds is stronger
Where RSS to JSON API | RSS, Atom & Podcast Feeds is stronger
- Straightforward feed to JSON conversion with a minimal input surface
- Covers RSS, Atom, JSON Feed and podcast feeds
- Entries are shaped to drop into a spreadsheet or automation
Where this API is stronger
- Only new mode with stored state for scheduled runs
- Archive history adds older items to a run
- Rows include author, categories and enclosures per item
RSS reading is a small and well covered niche. automation-lab has the largest audience and bills per item with a start fee, santamaria-automations bills per feed parsed, technicaldost adds feed discovery and error rows, and xtech keeps a minimal feed to JSON conversion. Ours adds only new mode, archive history and item level filters.
Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.
How to run it
- Put feed URLs in feedUrls, for example https://feeds.bbci.co.uk/news/rss.xml and https://hnrss.org/frontpage; a plain web page also works if it advertises a feed.
- Set maxItemsPerFeed and maxTotalItems to bound the run, for example 10 per feed and 50 in total.
- Turn on onlyNew for a scheduled task, or includeArchive to fill in items the live feed no longer carries.
- Optional: add keywords, or publishedAfter and publishedBefore, to narrow the rows.
- Start the run in the Apify Console and read the dataset; the RUN_SUMMARY record lists each feed with its status and item counts.
- Export as JSON, CSV or Excel, or fetch the dataset through the Apify API.
cURL
curl -X POST "https://api.apify.com/v2/acts/subimpact~rss-feed-reader/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"feedUrls":["https://feeds.bbci.co.uk/news/rss.xml","https://hnrss.org/frontpage"],"maxItemsPerFeed":50,"maxTotalItems":100,"maxConcurrency":5}'Python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/rss-feed-reader").call(run_input={"feedUrls":["https://feeds.bbci.co.uk/news/rss.xml","https://hnrss.org/frontpage"],"maxItemsPerFeed":50,"maxTotalItems":100,"maxConcurrency":5})
for item in client.dataset(run["default_dataset_id"]).iterate_items():
print(item)JavaScript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/rss-feed-reader').call({"feedUrls":["https://feeds.bbci.co.uk/news/rss.xml","https://hnrss.org/frontpage"],"maxItemsPerFeed":50,"maxTotalItems":100,"maxConcurrency":5});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);MCP
claude mcp add subimpact-data -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> -- npx -y @subimpact/data-mcp
# Then ask your agent to use the rss_feed_reader tool.n8n
Use the Apify node (Run an Actor).
Actor ID: subimpact/rss-feed-reader
Input JSON: paste the example input above.
MCP users: @subimpact/data-mcp exposes these actors as tools, so an agent can call rss_feed_reader directly.
Limits
- maxItemsPerFeed cannot exceed what the feed itself publishes; many feeds carry only 10 to 20 items.
- Dates a feed does not supply become null, and undated items drop out when a date filter is set.
- The archive covers 350+ news publisher feeds only; other feeds return live items with a note.
- Requests time out after 25 seconds, follow at most 5 redirects and reject responses above 15 MB.
Questions people ask
What does an item cost?
$0.0005 per delivered item, which is $0.50 per 1,000 items, charged only after a row has been pushed. There is no meaningful start fee beyond the platform minimum, and compute is included. Error feeds, empty feeds and items removed by your filters are free.
Which feed formats are supported?
RSS 2.0, RSS 1.0 (RDF), Atom 1.0 and JSON Feed 1.x, all mapped to the same field names. An HTML page with no feed link is reported as a feed error, and a page that advertises a feed is followed automatically.
How does only-new mode remember what it sent?
It stores one record per feed in a named key-value store, default rss-feed-reader-state, with the item keys and canonical links delivered so far, up to 2,000 per feed. Canonical links mean an item is still recognised when a feed changes its guids. A different stateStoreName gives independent tracking.
What does the archive add?
Older items that the live feed has already dropped, for the 350+ news publisher feeds in the index. Archive rows carry fromArchive set to true and are merged and de-duplicated with live items. Feeds outside the index simply return live items plus a short note, and an unreachable archive does not fail the run.
Why are some dates null?
When a feed provides no date, or the date cannot be parsed, publishedAt is null rather than guessed. While a date filter is set, undated items are excluded because their range cannot be proven. Feeds that omit dates are common, so a null here is expected rather than a fault.
How many items can I get per feed?
maxItemsPerFeed defaults to 50 and takes 1 to 1,000, with maxTotalItems as a global cap defaulting to 100. A feed that only publishes 10 or 20 items cannot give more than it holds, which is where the archive option fills the gap.
Can I use it in n8n or an AI agent?
Yes. Start a run through the Apify API and read the dataset, or connect the Actor as an MCP tool. Items arrive as plain JSON rows with ISO dates and a stable itemKey, which is what a scheduling node or an agent loop needs to avoid reprocessing the same article.
Need a data source that is not here?
We build and run scrapers for sites that have no public API. Tell us the site, the fields and how often you need them.