Retrieve sources

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.

The language(s) of the search. The only accepted format is the two-letter ISO 639-1 code. To select multiple languages, use a comma-separated string or an array of strings.

Examples:

• "en,es"
• ["en", "es"]

To learn more, see Enumerated parameters > Language.

The countries where the news publisher is located. The accepted format is the two-letter ISO 3166-1 alpha-2 code. To select multiple countries, use a comma-separated string or an array of strings.

Examples:

• "US,CA"
• ["US", "CA"]

To learn more, see Enumerated parameters > Country.

Predefined top sources per country.

Format: start with the word top, followed by the number of desired sources, and then the two-letter country code ISO 3166-1 alpha-2.

Examples:

• "top 100 US"
• "top 33 AT"
• "top 5 GB"

Multiple countries can be specified with custom numbers as a comma-separated string or an array of strings.

Examples:

• "top 50 US, top 20 GB"
• ["top 50 US", "top 20 GB"]

Specifies terms to search within the source names. To specify multiple terms, use a comma-separated string or an array of strings.

Examples:

• "sport, tech"
• ["sport", "tech"]

Note: The search does not require an exact match and returns all sources that include the specified terms anywhere in their names. You can use any word, phrase, or outlet name, such as "sport", or "new york times". For example, using "sport" as a term returns sources like "Motorsport", "Dot Esport", and "Tuttosport".

The domains of the news publication to search for. To specify multiple news sources, use a comma-separated string or an array of strings.

Examples:

• "bbc.com, nytimes.com"
• ["bbc.com", "nytimes.com"]

Caution: When specifying the source_url parameter, you can only use include_additional_info as an extra parameter.

If true, returns the following additional datapoints about each news source:

• nb_articles_for_7d: The number of articles published by the source in the last week.
• country: Source country of origin.
• rank: SEO rank.
• is_news_domain: Boolean indicating if the source is a news domain.
• news_domain_type: Type of news domain (e.g., "Original Content").
• news_type: Category of news (e.g., "General News Outlets").

If true, filters results to include only news domains.

Filters results based on the news domain type. Possible values are:

• Original Content: Sources that produce their own content.
• Aggregator: Sources that collect content from various other sources.
• Press Releases: Sources primarily publishing press releases.
• Republisher: Sources that republish content from other sources.
• Other: Sources that don't fit into main categories.

Filters results based on the news type. Multiple types can be specified using a comma-separated string or an array of strings.

Examples:

• "General News Outlets,Tech News and Updates"
• ["General News Outlets", "Tech News and Updates"]

For a complete list of available news types, see Enumerated parameters > News type.

The lowest boundary of the rank of a news website to filter by. Range: 1 to 999999, where a lower rank indicates a more popular source. If you set this to 100, the API includes sources ranked 100 or higher.

The highest boundary of the rank of a news website to filter by. Range: 1 to 999999, where a lower rank indicates a more popular source. If you set this to 100, the API includes sources ranked 100 or lower.

A message indicating the result of the request.

A list of news sources that match the specified criteria.

The user input parameters for the request.