Links

v3 Sources

get
https://v3-api.newscatcherapi.com/api
/sources
Get the list of sources in our database
You must specify at least one of lang, countries, predefined_sources, source_name, or source_url.
Parameters
Query
lang
string
Language(s) that the news outlet publishes in
countries
string
Country of the news publication
predefinied_sources
string
Get the lists behind out TOP predefined sources per country.
The format should be strictly like this:
- starting with word top
- put the number of desired sources top source
- 2 letter country code ISO 3166-1 alpha-2
For example:
top 100 US
top 33 AT
top 5 GB
It is also possible to put multiple countries with custom number of top sources, should be comma separated.
For example:
top 100 US, GB
top 33 AT, 55 IT
include_additional_info
boolean
When set to True, you get the following additional datapoints about each news source: - nb_articles_for_7d : number of articles published by the source in the last week. - country: it's country of the origin - rank: SEO rank
from_rank
integer
[0:999999] The lowest boundary of the rank of a news website to filter by. Important: lower rank means that a source is more popular
to_rank
integer
[0:999999] The highest boundary of the rank of a news website to filter by.
source_name
string
search using the name of the news publication. This parameter does not exact matching, so searching for 'sport' will return all sources with sport in their name like: 'Motorsport', 'Dot Esport', 'Tuttosport', etc
source_url
string
search using the domain of the news publication You can not use the source_url parameter in combination with any other parameter
Header
x-api-token*
string
your API key
Responses
200: OK
Success
401: Unauthorized
Invalid API Key
408: Request Timeout
Request timed out
422: Unprocessable Entity
Validation Error
429: Too Many Requests
Too many API calls
post
https://v3-api.newscatcherapi.com/api
/sources
Get the list of sources in our database
Parameters
Header
x-api-token*
string
your API key
Body
lang
string
Language(s) that the news outlet publishes in
countries
string
Country of the news publication
predefinied_sources
string
Get the lists behind out TOP predefined sources per country.
The format should be strictly like this:
- starting with word top
- put the number of desired sources top source
- 2 letter country code ISO 3166-1 alpha-2
For example:
top 100 US
top 33 AT
top 5 GB
It is also possible to put multiple countries with custom number of top sources, should be comma separated.
For example:
top 100 US, GB
top 33 AT, 55 IT
include_additional_info
boolean
When set to True, you get the following additional datapoints about each news source: - nb_articles_for_7d : number of articles published by the source in the last week. - country: it's country of the origin - rank: SEO rank
from_rank
integer
[0:999999] The lowest boundary of the rank of a news website to filter by. Important: lower rank means that a source is more popular
to_rank
integer
[0:999999] The highest boundary of the rank of a news website to filter by.
source_name
string
search using the name of the news publication. This parameter does not exact matching, so searching for 'sport' will return all sources with sport in their name like: 'Motorsport', 'Dot Esport', 'Tuttosport', etc
source_url
string
search using the domain of the news publication You can not use the source_url parameter in combination with any other parameter
Responses
200: OK
Success
401: Unauthorized
Invalid API key
408: Request Timeout
Request timed out
422: Unprocessable Entity
Validation Error
429: Too Many Requests
Too many API calls