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

Name
Type
Description

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

Name
Type
Description

x-api-token*

string

your API key

{
  "message": "Maximum sources displayed according to your plan is set to 1000",
  "sources": [
    {
      "name_source": "Yahoo",
      "domain_url": "yahoo.com",
      "logo": null,
      "additional_info": {
        "nb_articles_for_7d": 49838,
        "country": "US",
        "rank": 31
      }
    },
    {
      "name_source": "Daily Political",
      "domain_url": "dailypolitical.com",
      "logo": null,
      "additional_info": {
        "nb_articles_for_7d": 12330,
        "country": "US",
        "rank": 793836
      }
    }..
]
}

Get the list of sources in our database

POST https://v3-api.newscatcherapi.com/api/sources

Headers

Name
Type
Description

x-api-token*

string

your API key

Request Body

Name
Type
Description

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

{
  "message": "Maximum sources displayed according to your plan is set to 1000",
  "sources": [
    {
      "name_source": "Yahoo",
      "domain_url": "yahoo.com",
      "logo": null,
      "additional_info": {
        "nb_articles_for_7d": 49838,
        "country": "US",
        "rank": 31
      }
    },
    {
      "name_source": "Daily Political",
      "domain_url": "dailypolitical.com",
      "logo": null,
      "additional_info": {
        "nb_articles_for_7d": 12330,
        "country": "US",
        "rank": 793836
      }
    }..
]
}

Last updated