GET
/
latest_headlines

Authorizations

x-api-key
string
headerrequired

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.

Query Parameters

lang
enum<string>

Specifies the languages of the search. For example: en. The only accepted format is ISO 639-1 — 2 letter code.

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_lang
enum<string>

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
countries
string

Countries where the news publisher is located. One or multiple countries can be used in the search. The only acceptable format is ISO 3166-1 alpha-2 For example, US,CA,MX or just US

Important: This parameter is not responsible for the countries mentioned in the news article.

not_countries
string

The inverse of the countries parameter.

topic
enum<string>

The topic to which you want to restrict the articles of your choice. Not all news articles are assigned with a topic, therefore, we cannot guarantee that 100% of topics talking about technology will be assigned a tech label.

Available options:
news,
sport,
tech,
world,
finance,
politics,
business,
economics,
entertainment,
beauty,
travel,
music,
food,
science,
gaming
sources
string

One or more news resources to filter your search. It should be the normal form of the URL, For example: nytimes.com,theguardian.com

not_sources
string

One or more sources to be excluded from the search. Comma-separated list. For example: nytimes.com,cnn.com,wsj.com

when
string

The time period you want to get the latest headlines for.

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)

Default: The number of historic data available for your subscription plan

ranked_only
boolean

Default: True Limit the search only for the sources which are in the top 1 million online websites. Unranked sources are assigned a rank that equals 999999

page_size
integer

[1:100] How many articles to return per page.

Required range: 1 < x < 100
page
integer

The number of the page. Use it to scroll through the results. This parameter is used to paginate: scroll through results because one API response cannot return more than 100 articles.

Required range: x > 1

Response

200 - application/json

The response for a successful latest headlines request.

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.

page
integer

The current page number.

total_pages
integer

The total number of pages.

page_size
integer

The number of results per page.

articles
object[]

A list of articles.

user_input
object

The user input for a latest headlines request.