Sources
This endpoint returns the subset of news publishers that top headlines (/v2/top-headlines
) are available from. It’s mainly a convenience endpoint that you can use to keep track of the publishers available on the API, and you can pipe it straight through to your users.
Live Examples
Request parameters
-
category
Find sources that display news of this category. Possible options:
business
entertainment
general
health
science
sports
technology
. Default: all categories. -
country
Find sources that display news in a specific country. Possible options:
ae,
ar,
at,
au,
be,
bg,
br,
ca,
ch,
cn,
co,
cu,
cz,
de,
eg,
fr,
gb,
gr,
hk,
hu,
id,
ie,
il,
in,
it,
jp,
kr,
lt,
lv,
ma,
mx,
my,
ng,
nl,
no,
nz,
ph,
pl,
pt,
ro,
rs,
ru,
sa,
se,
sg,
si,
sk,
th,
tr,
tw,
ua,
us,
ve,
za,
. Default: all countries. -
apiKeyREQUIRED
Your API key. Alternatively you can provide this via the
X-Api-Key
HTTP header.
Response object
-
statusstring
If the request was successful or not. Options:
ok
,error
. In the case oferror
acode
andmessage
property will be populated. -
sourcesarray[source]
The results of the request.
-
idstring
The identifier of the news source. You can use this with our other endpoints.
-
namestring
The name of the news source
-
descriptionstring
A description of the news source
-
urlstring
The URL of the homepage.
-
categorystring
The type of news to expect from this news source.
-
languagestring
The language that this news source writes in.
-
countrystring
The country this news source is based in (and primarily writes about).
-