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: business entertainment general health science sports technology . Default: all categories.
Find sources that display news in a specific language. Possible options: ar de en es fr he it nl no pt ru se ud zh . Default: all languages.
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.
Your API key. Alternatively you can provide this via the X-Api-Key HTTP header.
If the request was successful or not. Options: ok, error. In the case of error a code and message property will be populated.
The results of the request.
The identifier of the news source. You can use this with our other endpoints.
The name of the news source
A description of the news source
The URL of the homepage.
The type of news to expect from this news source.
The language that this news source writes in.
The country this news source is based in (and primarily writes about).