> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/read_feed

# read_feed

> The items of any RSS or Atom feed: title, link, date, author and summary. ₹0.12 per call; a result that finds nothing is ₹0.

## What it does

The items of any public RSS or Atom feed from its url: data with one row per item carrying the title, link, publication time, author, the first 300 characters of the summary and the item's id, up to limit rows.

Use it to follow a blog, a news section, a podcast feed or a competitor's changelog without scraping; [`get_medium_posts`](https://parel.si/docs/tools/get_medium_posts.md) and [`get_substack_posts`](https://parel.si/docs/tools/get_substack_posts.md) do the same for those platforms, [`read_page`](https://parel.si/docs/tools/read_page.md) reads one article in full. Flat price per call; a URL that is not a feed, or an empty feed, is free. One to three seconds.

India: any public feed; Indian news sites and blogs publish RSS widely.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `url` | string | yes | The feed's URL (RSS or Atom). |
| `limit` | integer | no | How many items, up to 100. Default 25.; max 100 |

## What drives the cost

Flat per call for up to 100 items. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.12** per call (`cost_paise: 12`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "read_feed"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "read_feed"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"read_feed","input":{"url":"https://www.thehindu.com/news/national/feeder/default.rss","limit":25}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
[
  {
    "author": "",
    "id": "article-71670207",
    "link": "https://www.thehindu.com/news/national/kerala/appointment-process-for-tribal-mentor-teachers-going-at-a-slow-pace-in-keralam/article71670207.ece",
    "published": "Thu, 05 Nov 2026 20:31:20 +0530",
    "summary": "Social activists are concerned if the delay will aggravate the dropping out of students from these communities.",
    "title": "Appointment process for tribal mentor-teachers going at a slow pace in Keralam"
  },
  {
    "author": "",
    "id": "article-71670308",
    "link": "https://www.thehindu.com/news/national/karnataka/appeal-for-eco-friendly-deepavali-bursting-crackers-permitted-only-between-8-pm-and-10-pm/article71670308.ece",
    "published": "Thu, 05 Nov 2026 20:30:22 +0530",
    "summary": "",
    "title": "Appeal for eco-friendly Deepavali: Bursting crackers permitted only between 8 p.m. and 10 p.m."
  },
  {
    "author": "",
    "id": "article-71669650",
    "link": "https://www.thehindu.com/news/national/kerala/new-posting-for-former-kochi-city-police-chief/article71669650.ece",
    "published": "Thu, 05 Nov 2026 20:28:34 +0530",
    "summary": "",
    "title": "New posting for former Kochi City Police chief"
  }
]
```

## Notes

- Flat per call for up to 100 items.
- The url must be the feed itself, not the site's home page; a page that is not a feed is free.
- Pairs with read_page for the full article.

## Siblings

- [`get_medium_posts`](https://parel.si/docs/tools/get_medium_posts.md)
- [`get_substack_posts`](https://parel.si/docs/tools/get_substack_posts.md)
- [`read_page`](https://parel.si/docs/tools/read_page.md)
