Sources

List news sources

This endpoint allows you to get the list of sources that are available in the database. You can filter the sources by language and country. The maximum number of sources displayed is set according to your plan. You can find the list of plans and their features here: https://newscatcherapi.com/news-api#news-api-pricing source_url and predefined_sources are each mutually exclusive with every other filter field (only include_additional_info may be combined with either of them); at least one of lang, countries, source_url, source_name, or predefined_sources must be provided.

post/api/sources

Request

  • Base URL
    https://v3-api.newscatcherapi.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared. Required headers: x-api-token

Headers

x-api-tokenstring required

Your NewsCatcher API key, used to authenticate this request.

Request body

langunknown
countriesunknown
predefined_sourcesunknown
include_additional_infoboolean

Includes extra domain-level information (e.g. traffic/audience data) for each source in the response.

from_rankinteger

Minimum source rank (lower rank = more authoritative/popular source). Integer between 1 and 999999.

to_rankinteger

Maximum source rank (lower rank = more authoritative/popular source). Integer between 1 and 999999.

source_nameunknown
source_urlunknown
news_domain_typeunknown
news_typeunknown

Response

Successful Response

OR

Changes

No recorded changes to this operation across all 1 revision of this API.