# RSS Feed Reader: RSS & Atom to JSON, Bulk, $1/1K (`conserving_celerytop/rss-feed-reader`) Actor

Read any list of RSS and Atom feeds and get one row per item: title, link, publication date, summary, categories, image and enclosure, optionally the full content. Filter by date. $1 per 1,000 items; broken feeds are free.

- **URL**: https://apify.com/conserving\_celerytop/rss-feed-reader.md
- **Developed by:** [Don Mangu](https://apify.com/conserving_celerytop) (community)
- **Categories:** News, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 feed items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## RSS Feed Reader: RSS & Atom to JSON, Bulk, $1/1K

This RSS feed reader turns any list of RSS and Atom feeds into clean rows, one per item, with title, link, publication date, summary, categories, image and attached file. It is an RSS to JSON converter that also exports CSV or Excel, so you can follow news sites, blogs, podcasts, release notes and job feeds from one place.

**Cost:** $0.001 per item ($1 per 1,000). Feeds that cannot be read, addresses that are not feeds, and invalid entries are free. No login or API key.

### How to convert RSS feeds to JSON

1. Paste feed addresses into **Feed URLs**, one per line.
2. Set **Items per feed** and, if you want, **Published since** (a date or a period such as 7 days).
3. Turn on **Include full content** if you need the whole text of each item.
4. Click **Start**, then open the **Feed items** table or download the rows.

It reads RSS 2.0, RSS 1.0 and Atom, with dates normalized to ISO 8601, HTML stripped from summaries, and relative links made absolute. Items come newest first. The form opens with NASA's news feed and the GOV.UK news feed, 5 items each, and costs about one cent. Use it for news and content monitoring on a schedule, to feed Make, Zapier, n8n or a Slack channel through the Apify API, or to collect titles, links and summaries as JSON for an AI agent or an index.

### How much does the RSS feed reader cost?

| Event | Price |
|---|---|
| Feed item (`feed-item`) | $0.001 ($1 per 1,000) |
| Feed that cannot be read, not a feed, or invalid address | Free |

Apify adds only its small standard fee per run start. You can set a spending limit on any run, and the Actor stops cleanly when it is reached.

Example: you follow 40 feeds daily and get 25 new items from each, so 1,000 items a day cost $1.00, about $30 a month.

### Input

```json
{
  "feedUrls": [
    "https://www.nasa.gov/news-release/feed/",
    "https://www.gov.uk/search/news-and-communications.atom"
  ],
  "maxItemsPerFeed": 5
}
```

### Output

One row per result:

```json
{
  "feedUrl": "https://www.nasa.gov/news-release/feed/",
  "feedTitle": "NASA",
  "title": "Uncovering the Valleys Hidden Below Greenland's Ice",
  "url": "https://science.nasa.gov/earth/earth-observatory/uncovering-the-valleys-hidden-below-greenlands-ice/",
  "publishedAt": "2026-09-28T04:00:00.000Z",
  "summary": "Greenland is capped with a vast ice sheet ...",
  "categories": [
    "Earth"
  ],
  "status": "ok",
  "charged": true
}
```

`status` is `ok` for items, which are charged. A feed that cannot be read gives one free row with `feed_error`, `not_a_feed`, `robots_disallowed` or `not_found` and the reason in `error`. A STATS record in the key-value store counts items, free rows and requests.

### Related Actors

- [Article Extractor](https://apify.com/conserving_celerytop/article-extractor): Use it to pull clean article text, dates and metadata from news and blog pages.
- [Podcast Scraper API](https://apify.com/conserving_celerytop/podcast-episode-scraper): Use it to list every episode of a podcast with audio file URLs from its RSS feed.
- [Web Page to Markdown for AI](https://apify.com/conserving_celerytop/web-page-to-markdown): Use it to turn web pages into clean Markdown for LLMs, RAG and AI agents.
- [Sitemap URL Extractor API](https://apify.com/conserving_celerytop/sitemap-url-extractor): Use it to list every page URL of a website from its XML sitemaps.

### FAQ

**Which feed formats work?** RSS 2.0, RSS 1.0 (RDF) and Atom 1.0, also served gzipped.

**Does it respect robots.txt?** Yes. It reads each site's robots.txt and skips feeds the site does not allow for the token DonMangu-RSSReader or for all crawlers. Those rows are free.

**Can I get only new items on a schedule?** Set **Published since** to a period such as 24 hours and schedule the Actor daily.

**Does it include author names?** No. Items are returned without author names or emails.

# Actor input Schema

## `feedUrls` (type: `array`):

Enter RSS or Atom feed addresses, one per line.

## `maxItemsPerFeed` (type: `integer`):

Return at most this many of the newest items from each feed.

## `publishedSince` (type: `string`):

Keep only items published on or after this date, as 2026-09-01 or a period such as 24 hours or 7 days. Leave empty for all.

## `includeContent` (type: `boolean`):

Add the full item content (content:encoded or Atom content) as plain text, when the feed has it.

## `maxResults` (type: `integer`):

Stop after this many items in total.

## Actor input object example

```json
{
  "feedUrls": [
    "https://www.nasa.gov/news-release/feed/",
    "https://www.gov.uk/search/news-and-communications.atom"
  ],
  "maxItemsPerFeed": 5,
  "includeContent": false,
  "maxResults": 1000
}
```

# Actor output Schema

## `overview` (type: `string`):

Feed items

## `errors` (type: `string`):

Feed problems

## `all` (type: `string`):

Every row with every field.

## `stats` (type: `string`):

Results, free rows, requests and time.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "feedUrls": [
        "https://www.nasa.gov/news-release/feed/",
        "https://www.gov.uk/search/news-and-communications.atom"
    ],
    "maxItemsPerFeed": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("conserving_celerytop/rss-feed-reader").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "feedUrls": [
        "https://www.nasa.gov/news-release/feed/",
        "https://www.gov.uk/search/news-and-communications.atom",
    ],
    "maxItemsPerFeed": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("conserving_celerytop/rss-feed-reader").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "feedUrls": [
    "https://www.nasa.gov/news-release/feed/",
    "https://www.gov.uk/search/news-and-communications.atom"
  ],
  "maxItemsPerFeed": 5
}' |
apify call conserving_celerytop/rss-feed-reader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,conserving_celerytop/rss-feed-reader"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/eslFPtlgj1XyMJOm7/builds/hw9beUdgn6EfQcQwY/openapi.json