Get latest headlines

Authorizations

x-api-key

string

header

required

API Key to authenticate requests.

To access the API, include your API key in the x-api-key header. To obtain your API key, complete the form or contact us directly.

Body

application/json

countries

string

The countries where the news publisher is located, using the ISO 3166-1 alpha-2 format. Multiple countries can be specified, separated by commas.

lang

enum<string>

The language you want to search in.

Available options:

af,

ar,

bg,

bn,

ca,

cn,

cs,

cy,

da,

de,

el,

en,

es,

et,

fa,

fi,

fr,

gu,

he,

hi,

hr,

hu,

id,

it,

ja,

kn,

ko,

lt,

lv,

mk,

ml,

mr,

ne,

nl,

no,

pa,

pl,

pt,

ro,

ru,

sk,

sl,

so,

sq,

sv,

sw,

ta,

te,

th,

tl,

tr,

tw,

uk,

ur,

vi

not_countries

string

The countries to exclude from the search results, using the ISO 3166-1 alpha-2 format. Multiple countries can be specified, separated by commas.

not_lang

enum<string>

The language to exclude from the search results. Inverse to the lang parameter.

Available options:

af,

ar,

bg,

bn,

ca,

cn,

cs,

cy,

da,

de,

el,

en,

es,

et,

fa,

fi,

fr,

gu,

he,

hi,

hr,

hu,

id,

it,

ja,

kn,

ko,

lt,

lv,

mk,

ml,

mr,

ne,

nl,

no,

pa,

pl,

pt,

ro,

ru,

sk,

sl,

so,

sq,

sv,

sw,

ta,

te,

th,

tl,

tr,

tw,

uk,

ur,

vi

not_sources

string

The news sources to exclude from the search, specified as a comma-separated list. For example, nytimes.com,cnn.com,wsj.com.

page

integer

The page number for paginated results. Use it to scroll through the results, as one API response cannot return more than 100 articles.

Required range: x > 1

page_size

integer

The number of articles to return per page. Range: [1:100].

Required range: 1 < x < 100

ranked_only

boolean

If true, limits the search to sources in the top 1 million online websites. Unranked sources are assigned a rank of 999999.

sources

string

The news sources to filter the search, specified in the normal form of the URL. For example, nytimes.com,theguardian.com.

topic

enum<string>

The topic to restrict the articles to.

Available options:

news,

sport,

tech,

world,

finance,

politics,

business,

economics,

entertainment,

beauty,

travel,

music,

food,

science,

gaming

when

string

default:

The time period for which you want to get the latest headlines. Accepted forms:

7d: Dailly Form (last 7 days time period), 30d (last 30 days time period)
1h: Hourly Form (last hour), 24h (last 24 hours)

Response

200 - application/json

The response for a successful latest headlines request.

articles

object[]

A list of articles.

page

integer

The current page number.

page_size

integer

The number of results per page.

status

enum<string>

The status of the response.

Available options:

ok,

No matches for your search.

total_hits

integer

The total number of hits for the search.

total_pages

integer

The total number of pages.

user_input

object

The user input for a latest headlines request.

Overview

Endpoints

Authorizations

Body

Response