subimpact WhatsApp us

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

FieldTypeDescription
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
FieldTypeDescription
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

FieldTypeRequiredDescriptionDefault
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

EventWhat it meansPriceLowest 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 Pay per event $0.5 $0.5 $0.00005 Included 2 No reviews yet 18 Nov 2026
RSS Feed Reader: RSS, Atom & JSON Feeds to JSON Direct match, pay per event $1.15 $0.6 $0.035 Included 208 No reviews yet 16 Nov 2026
RSS & Atom Feed Reader - Monitor Any Feed at Scale Direct match, pay per event 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 Direct match, pay per event $8.00 $8.00 None Included 106 5.0 (1 review) 8 Nov 2026
RSS to JSON API | RSS, Atom & Podcast Feeds Direct match, pay per event $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

  1. 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.
  2. Set maxItemsPerFeed and maxTotalItems to bound the run, for example 10 per feed and 50 in total.
  3. Turn on onlyNew for a scheduled task, or includeArchive to fill in items the live feed no longer carries.
  4. Optional: add keywords, or publishedAfter and publishedBefore, to narrow the rows.
  5. Start the run in the Apify Console and read the dataset; the RUN_SUMMARY record lists each feed with its status and item counts.
  6. 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.