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,
top,
hn-frontpage,
ai-news,
tech-news

Query Parameters

limit
integer
default:20

Number of results to return.

Required range: 1 <= x <= 50
noCache
boolean
default:false

Bypass the cache and fetch a fresh feed.

Response

Curated news feed

results_type
string
required

The type of results returned (e.g., Search, News, Weather, Calculator). 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.

metrics
object
required

Search performance metrics. Always included in the response.

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.

disambiguation
object

Possible meanings when the query is ambiguous.

aiSummary
object

News feeds only: the pre-written news summary. The same text is in answer.

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 results, when the search found any.

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.