Zum Inhalt springen
POST AI agent ready /v1/rss/parse

RSS Parser API - Convert RSS and Atom Feeds to JSON

Fetches a feed URL and parses RSS 2.0 or Atom. Detects format automatically and returns channel/feed metadata (title, link, description) plus an items array with title, link, description, published date, and author for each entry. CDATA wrappers are stripped from text.

Parameters

stringrequired

HTTP or HTTPS URL of the feed.

number

Maximum number of items to return. Defaults to 50, max 500.

Code examples

curl -X POST https://api.botoi.com/v1/rss/parse \
  -H "Content-Type: application/json" \
  -d '{"url":"https://news.ycombinator.com/rss","limit":3}'

When to use this API

Aggregate industry news into a Slack channel

Poll a list of blog RSS feeds hourly. For each new item, post to Slack with the title and link. Replaces paid newsreader subscriptions for small teams.

Populate a newsroom or blog hub

Parse several partner feeds on your site and render the most recent 10 items across all of them. The feed metadata (title, description) lets you attribute each item to its source.

Monitor podcast feed updates

Podcast feeds are Atom or RSS. Poll each show's feed nightly and alert when a new item is published. Useful for building a "new episodes this week" digest.

Frequently asked questions

Does this support both RSS and Atom?
Yes. The parser auto-detects based on the document's root element (<rss> or <feed>) and namespace. The response includes a format field set to "rss" or "atom".
What is the maximum items returned?
The limit parameter defaults to 50 and is capped at 500 per request. Feeds with more entries are truncated; fetch the feed again with a higher limit if needed.
How are dates formatted?
The published field contains the raw date string from the feed (typically RFC 822 for RSS, ISO 8601 for Atom). Parse it with your language's standard date library. Empty when the feed item has no date.
What about feeds that require authentication?
Not supported. The endpoint fetches the URL anonymously with a BotoiBot user-agent. Feeds behind basic auth, cookies, or private tokens will fail with FETCH_FAILED.
How large a feed can I parse?
The fetch has a 15-second timeout and parses up to the configured limit of items. Large feeds (hundreds of entries) parse fine within that budget, but extremely large dumps may time out.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs