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.
Find sources that display news of this category. Possible options: businessentertainmentgeneralhealthsciencesportstechnology . Default: all categories.
language
Find sources that display news in a specific language. Possible options: ardeenesfrheitnlnoptruseudzh . Default: all languages.
country
Find sources that display news in a specific country. Possible options: aearataubebgbrcachcncocuczdeegfrgbgrhkhuidieilinitjpkrltlvmamxmyngnlnonzphplptrorsrusasesgsiskthtrtwuausveza . Default: all countries.
apiKey
required
Your API key. Alternatively you can provide this via the X-Api-Key HTTP header.
Response object
status
string
If the request was successful or not. Options: ok, error. In the case of error a code and message property will be populated.
sources
array[source]
The results of the request.
id
string
The identifier of the news source. You can use this with our other endpoints.
name
string
The name of the news source
description
string
A description of the news source
url
string
The URL of the homepage.
category
string
The type of news to expect from this news source.
language
string
The language that this news source writes in.
country
string
The country this news source is based in (and primarily writes about).