Skip to main content
GET
Get a curated news feed

Authorizations

x-api-key
string
header
required

API key from the API Console.

Path Parameters

topic
enum<string>
required

Topic slug selecting the feed.

Available options:
technology,
business,
finance,
politics,
sports,
health,
science,
world,
entertainment,
us,
europe,
uk,
asia,
middle-east,
africa,
latin-america,
australia,
programming,
startups,
media,
crypto,
legal,
space,
top,
hn-frontpage,
ai-news,
tech-news

Query Parameters

limit
integer
default:20

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

Required range: 1 <= x <= 100
format
enum<string>
default:json

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.

Available options:
json,
context,
rss,
embed,
ticker
q
string

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).

Maximum string length: 200
query
string

Alias of q.

Maximum string length: 200
hours
integer
default:48

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

Required range: 1 <= x <= 336
since
string

Return only stories Andi first saw at or after this time: ISO 8601 or Unix seconds. To poll, send the time of your previous poll; a few stories near the boundary may repeat. Filters on when Andi first saw a story, not on its rank. Stories with no recorded first-seen time are kept. An invalid value is ignored with a warning.

lang
string
default:en

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

summary
boolean
default:true

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

detail
enum<string>

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.

Available options:
full
extracts
boolean
default:false

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.

content
boolean
default:false

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.

maxContentLength
integer

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

metadata
enum<string>
default:basic

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

Available options:
basic,
full
title
string

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

Maximum string length: 80
tz
string

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

theme
enum<string>
default:light

format=ticker only: colour theme.

Available options:
light,
dark
speed
integer
default:60

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

Required range: 20 <= x <= 200
label
string

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

key
string

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.

noCache
boolean
default:false

Bypass the cache and fetch a fresh feed.

preset
enum<string>

Named defaults: app (ordinary defaults; direct calls) or agent (used by the MCP server and CLI; fills format=context, extracts=true and basic metadata). Any parameter you send wins.

Available options:
app,
agent
maxTokens
integer

Token budget for the articles (1,000 to 200,000), filled as on search: page content first, then extracts, then snippets.

Required range: 1000 <= x <= 200000

Response

Curated news feed in the requested format.

results_type
string
required

The type of results returned (e.g., Search, News, Weather, Calculator, TimeZone, Currency, Answer). Determines which optional response sections are present.

answer
string
required

Instant answer for the query when one is found — for example a definition, a weather line or a calculation — otherwise an empty string. On news feeds, a short summary of the headlines when available.

type
string
required

Same as results_type. Indicates the category of results.

title
string
required

Your query text (for a news feed, the feed's description).

results
object[]
required

Array of search results. Only rows with a web address appear; answers with no address (calculator, clock, currency, translation, quote, score) are in answer and their block.

metrics
object
required

Search performance metrics. Always included in the response.

answer_metadata
object

How the answer was made. kind is extractive, instant or llm; citations are the links of the rows it came from; passage is where on the row a quote came from; block (instant answers) names the response field that holds the answer's data (such as weather, calculation, time, currency, quote, score). It points to that field and never copies it. data appears only for a value that exists nowhere else, such as an extracted value.

correctedQuery
string

Spell-corrected query. Present when a misspelling in the original query is detected and corrected — any mode can return it; deep and exhaustive modes run the strongest spell correction.

Related search suggestions. Present on some queries.

topics
string[]

Related topics. Present on some queries.

Related topic names for entity answers.

infobox
object

Facts panel for an entity answer.

aiSummary
object

A pre-written news summary. News feeds return it, and so does search when the query asks for a whole feed (for example "latest technology news" or "hacker news"), but not for a topic inside a feed ("nfl news"). On news feeds the same text is in answer; on search, answer can hold something else, such as a description of the site.

filter_counts
object

Present when an author or publisher filter is set: how many shown results match it and how many have no known author or publisher.

locale
object

The language and country Andi searched for. Present on every search response (not on news feeds). With format=context, the same values appear in the frontmatter as language, language_confidence, language_source, country and local_scope.

Echo of the safe-search state. Present on cache misses. Use it to confirm your safe parameter was honored.

videos
object[]

Video results, when the search found any.

images
object[]

Image results, when the search found any.

news
object[]

News stories, when the search found any. Front pages, section pages, topic pages and listing pages are in categories, not here.

citations
object[]

Rows an answer cites, in the same shape as results. When a search names a whole curated news feed (for example "headlines" or "latest news from hacker news") and the response carries the feed's aiSummary, this lists the stories the summary cites in the summary's order, then the feed's other stories, up to limit. Left out when empty. Not on /api/v1/news.

categories
object[]

News front pages, section pages, topic or tag pages, listing pages and site-search pages. results still holds them too. Left out when empty. Not on /api/v1/news.

places
object[]

Place and business results, when the search found any.

profiles
object[]

People and entity profiles, when the search found any.

social
object[]

Social posts, when the search found any.

academic
object[]

Scholarly papers, when the search found any.

weather
object

Weather data. Present when the query triggers a weather intent.

calculation
object

Calculation result. Present when the query triggers a calculation intent.

preset
object

Which preset ran, how it was chosen and the defaults it filled in. Present only when a preset was chosen by preset= or by the calling surface (MCP server, CLI).

warnings
string[]

Notes on parts of the request the API adjusted or ignored, for example a limit above 10 lowered to 10 on instant.

time
object

Present when the query is a time or clock query.

currency
object

Present when the query is a currency conversion query.

translation
object

Present when the query is a translation query.

quote
object

Present when the query is a share price query.

score
object

Present when the query is a game score query.