v3 Sources
Get the list of sources in our database
GET
https://v3-api.newscatcherapi.com/api/sources
You must specify at least one of lang
, countries
, predefined_sources
, source_name
, or source_url
.
Query Parameters
lang
string
Language(s) that the news outlet publishes in
countries
string
Country of the news publication
predefined_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
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
Headers
x-api-token*
string
your API key
Get the list of sources in our database
POST
https://v3-api.newscatcherapi.com/api/sources
Headers
x-api-token*
string
your API key
Request 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
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
Last updated