Search news
Searches for articles based on specified criteria such as keyword, language, country, source, and more.
Authorizations
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
Keyword/keywords you're searching for. This is the most important part of your query. For for more examples and explanations, learn Advanced querying in News API v2.
Specifies the languages of the search. For example: en
.
The only accepted format is ISO 639-1 — 2 letter code.
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
Inverse to the lang
parameter
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
The precision of the published date. There are three types:
full
: The day and time of an article is correctly identified with the appropriate timezone.timezone unknown
: The day and time of an article is correctly identified without timezone.date
: Only the day is identified without an exact time.
full
, timezone unknown
, date
YYYY/mm/dd
From which point in time to start the search.
The default timezone is UTC.
Defaults to the past week.
YYYY/mm/dd
Until which point in time to search for.
The default timezone is UTC.
By default, we search what you specified in the q
parameter in both title
and summary
of the article.
However, you can limit this to either title
or summary
.
title
, summary
, title_summary
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.
The inverse of the countries
parameter.
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.
news
, sport
, tech
, world
, finance
, politics
, business
, economics
, entertainment
, beauty
, travel
, music
, food
, science
, gaming
One or more news resources to filter your search. It should be the normal form of the URL,
For example: nytimes.com,theguardian.com
One or more sources to be excluded from the search.
Comma-separated list. For example: nytimes.com,cnn.com,wsj.com
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
[0:999999]
The lowest boundary of the rank of a news website to filter by.
Important: lower rank means that a source is more popular
1 < x < 999999
[0:999999]
The upper boundary of the rank of a news website to filter by.
1 < x < 999999
relevancy
(default value) — the most relevant results first
date
— the most recently published results first
rank
— the results from the highest-ranked sources first
relevancy
, date
, rank
[1:100]
How many articles to return per page.
1 < x < 100
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.
x > 1
Response
The response for a successful search request.
The status of the response.
ok
, No matches for your search.
The total number of hits for the search.
The current page number.
The total number of pages.
The number of results per page.
An array of articles matching the search criteria.
The user input for a search request.
Was this page helpful?