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.
Request parameters
-
category
Find sources that display news of this category. Possible options:
businessentertainmentgeneralhealthsciencesportstechnology. 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-KeyHTTP header.
Response object
-
statusstring
If the request was successful or not. Options:
ok,error. In the case oferroracodeandmessageproperty 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).
-