POST
/
api
/
sources
Retrieve sources
curl --request POST \
  --url https://v3-api.newscatcherapi.com/api/sources \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '{
  "predefined_sources": [
    "top 50 US"
  ],
  "include_additional_info": true,
  "is_news_domain": true,
  "news_domain_type": "Original Content",
  "news_type": "General News Outlets"
}'
{
  "message": "<string>",
  "sources": [
    {
      "name_source": "<string>",
      "domain_url": "<string>",
      "logo": "<string>",
      "additional_info": {
        "nb_articles_for_7d": 153,
        "country": "US",
        "rank": 117,
        "is_news_domain": true,
        "news_domain_type": "Original Content",
        "news_type": "General News Outlets",
        "robots_compliant": true
      }
    }
  ],
  "user_input": {}
}

Authorizations

​
x-api-token
string
header
required

API Key to authenticate requests.

To access the API, include your API key in the x-api-token header. To obtain your API key, complete the form or contact us directly.

Body

application/json

Request body for searching news sources based on specified criteria such as language, country, and more.

The body is of type object.

Response

200
application/json

A successful response containing a list of news sources that match the specified criteria.

The response model for a successful Sources request retrieving news sources matching the specified criteria. Response field behavior:

  • Required fields are guaranteed to be present and non-null.
  • Optional fields may be null or undefined if the data point is not presented or couldn't be extracted during processing.