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 - 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

Headers

Name	Type	Description
x-api-token*	string	your API key

200: OK Success

{
  "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
      }
    }..
]
}

422: Unprocessable Entity Validation Error

{
  "message": "At least one field from [lang, countries, source_url, source_name, predefined_sources] is required",
  "status_code": 422,
  "status": "Validation error"
}

401: Unauthorized Invalid API Key

{
  "message": "Invalid api key: XXXXXXXXXXXXXXXXXXXXXXXX",
  "status_code": 401,
  "status": "Unauthorized"
}

429: Too Many Requests Too many API calls

{
  "status": "error",
  "error_code": "ConcurrencyViolation",
  "message": "Max concurrency allowed 1 per 1 second"
}

408: Request Timeout Request timed out

{
    "status": "error",
    "error_code": "RequestTimedOut",
    "message": "Request takes more than 30 seconds. Your search is too broad.Try to use more parameters to narrow down the request."
}

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 - 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

200: OK Success

{
  "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
      }
    }..
]
}

422: Unprocessable Entity Validation Error

{
  "message": "At least one field from [lang, countries, source_url, source_name, predefined_sources] is required",
  "status_code": 422,
  "status": "Validation error"
}

401: Unauthorized Invalid API key

{
  "message": "Invalid api key: XXXXXXXXXXXXXXXXXXXXXXXX",
  "status_code": 401,
  "status": "Unauthorized"
}

408: Request Timeout Request timed out

{
    "status": "error",
    "error_code": "RequestTimedOut",
    "message": "Request takes more than 30 seconds. Your search is too broad.Try to use more parameters to narrow down the request."
}

429: Too Many Requests Too many API calls

{
  "status": "error",
  "error_code": "ConcurrencyViolation",
  "message": "Max concurrency allowed 1 per 1 second"
}