How to turn a news search into an RSS feed#

To turn any APITube News API search into an RSS feed, add export=rss to your request to /v1/news/everything. Instead of the usual JSON, the API returns a standard RSS 2.0 document built from the same articles your filters select, so you can paste the URL straight into a feed reader. The feed is served with the content type application/xml; charset=utf-8.

curl "https://api.apitube.io/v1/news/everything?title=bitcoin&export=rss&api_key=YOUR_API_KEY"

You can send the key as a header (X-API-Key: YOUR_API_KEY) instead of the api_key parameter. The request above returns Bitcoin headlines as an RSS feed rather than JSON.

What does export=rss return?#

export=rss returns an RSS 2.0 feed. The <channel> carries a fixed title, “APITube News Feed”, and the description “Latest news articles from APITube News API”. Each article becomes one <item> with:

• <title> — the article headline
• <link> and <guid> — the article URL
• <description> — the article description
• <pubDate> — the article’s publish date

The response also sets Content-Disposition: inline; filename="rss.xml", so a browser opens it inline and a feed reader treats it as a feed file. Because the export runs after your normal search, the feed contains exactly the articles your query returns — every filter still applies.

How to build the feed from a filtered search#

Any filter you can use on /v1/news/everything shapes the feed. Combine keywords, language, source and date filters, then add export=rss at the end. This produces a feed of English-language headlines about electric vehicles, excluding one keyword:

curl "https://api.apitube.io/v1/news/everything?title=electric vehicle&language.code=en&ignore.title=opinion&export=rss&api_key=YOUR_API_KEY"

You can also drive the feed with the advanced Boolean language — see How to use AND, OR and NOT in news search — by adding a query parameter alongside export=rss. The export step does not change your filters; it only changes the output format.

How to control how many items appear in the feed#

The feed contains the articles from the current page of results, so use page and per_page to control its size. One request returns up to 250 items (per_page max 250); asking for more returns HTTP 400 with error ER0171. To pull a larger feed, raise per_page toward the limit or page through results and request additional pages:

curl "https://api.apitube.io/v1/news/everything?title=bitcoin&per_page=100&export=rss&api_key=YOUR_API_KEY"

For the full rules on page and per_page, see How to paginate through results.

How to subscribe to the feed#

To save the feed to a file, redirect the output:

curl "https://api.apitube.io/v1/news/everything?title=bitcoin&export=rss&api_key=YOUR_API_KEY" -o bitcoin.xml

To subscribe in a feed reader, give it the full request URL including your api_key and export=rss. The reader will poll that URL and show new matching articles as they appear. Because the key travels in the URL, treat that feed URL as a secret — anyone who has it can read your feed using your key. RSS is one of several non-JSON outputs: the same export parameter also accepts csv, tsv, xml, xlsx, jsonl (alias ndjson) and parquet. The canonical parameter list is in the official News API parameter reference.

Common Questions#

• Which RSS version does the feed use?
• Can I change the feed title or description?
• Do my search filters still work with export=rss?
• What other export formats are available?

Which RSS version does the feed use?#

The feed is RSS 2.0, served as application/xml; charset=utf-8 with the filename rss.xml. Standard feed readers and RSS libraries parse it without any special handling.

Can I change the feed title or description?#

No. The channel title (“APITube News Feed”) and description (“Latest news articles from APITube News API”) are fixed for every feed. What changes between feeds is the list of <item> entries, which is driven entirely by your search filters.

Do my search filters still work with export=rss?#

Yes. export=rss only changes the output format. The search runs first with all of your filters — title, language.code, source.*, date ranges, query and the rest — and the matching articles are then rendered as RSS items, so the feed always reflects your query.

What other export formats are available?#

Alongside rss, the export parameter accepts csv, tsv, xml, xlsx, jsonl (with the alias ndjson) and parquet. Omit export, or set export=json, to get the default JSON response.