Get a curated news feed

Topic slug selecting the feed.

Number of results to return. Values outside 1–50 are clamped.

Output format. json returns the response object. context returns markdown for language models (text/markdown), with the topic brief as a ## Summary block. rss returns an RSS 2.0 feed (application/rss+xml), with the brief in an andi:aiSummary element. embed returns a self-contained HTML widget (text/html). ticker returns a self-contained scrolling headline bar (text/html). Both can be loaded in an <iframe> with a feed key in the key parameter. A feed key works only with rss, embed and ticker. Any other value returns 400.

Keyword filter within the topic, ranked against your query. Up to 200 characters. A response to a q request carries no brief (aiSummary is absent and answer is empty).

Alias of q.

Recency window in hours. Values outside 1–336 are clamped. Defaults to 48; format=ticker defaults to 24 unless q is set.

Language code (for example en, es), or all for every language. An unrecognised value falls back to en.

Set to 0 or false to leave the topic brief out of this response (aiSummary is dropped and answer is empty).

Set to full to get the topic's detailed brief. Only topics that list detail: ["full"] in GET /api/v1/news have one (currently startups and space); other topics return their standard brief.

Include stored text passages from each article, in extracts[]. Defaults to true for format=context and when content=true; pass extracts=false to turn them off. Nothing is fetched live; the text comes from pages Andi has already stored.

Include each article's stored full text in reader.markdown. Also turns on extracts unless extracts=false is passed. Billed per token, as on search.

Maximum number of characters of reader.markdown to return per article. Only applies when content=true.

Metadata level for format=context. basic is the default.

format=embed only: heading shown in the widget. Up to 80 characters.

format=embed only: IANA time zone for displayed times, for example America/New_York.

format=ticker only: colour theme.

format=ticker only: scroll speed, from 20 to 200.

format=ticker only: short text shown on the ticker's label block.

A feed key, for links that cannot send a header (an <iframe>, a dashboard, a feed reader). Works only with format=rss, embed or ticker, and on GET /api/v1/news. Any other format, or no format, returns 403. A full API key in a URL returns 403: send it in the x-api-key header instead. Treat a feed-key link like a password.

Bypass the cache and fetch a fresh feed.