v1

latestOpenAPI 3.1.0Proprietary2026-07-1391579.5 KB

Sources

News sources

Returns up to 100 news sources matching the filters. Use the returned id with the domain parameter on the news endpoints.

Consumes 1 API credit per call.

get/1/sources

Query parameters

apikeystring

Your API key. Alternatively send it in the X-ACCESS-KEY HTTP header. One of the two MUST be present.

countrystring[]

Filter by country. Comma-separated ISO 3166-1 alpha-2 country codes, up to your plan's filter limit (default 5). Cannot be combined with excludecountry.

categorystring[]

Filter by category. Comma-separated category names, up to your plan's filter limit (default 5). Cannot be combined with excludecategory.

languagestring[]

Filter by language. Comma-separated ISO 639-1 language codes, up to your plan's filter limit (default 5). Cannot be combined with excludelanguage.

domainurlstring[]

Filter by news source domain, e.g. bbc.com. Comma-separated, up to your plan's filter limit (default 5). Cannot be combined with domain or excludedomain.

prioritydomain'top' | 'medium' | 'low'

Restrict results to a tier of news sources ranked by quality and popularity: top, medium, or low.

Response

Success.

status'success' required

totalResultsinteger required

Number of sources returned (maximum 100).

{"stackTrail":"components:schemas:SourceListEnvelope:properties:nextPage","oasType":"schema","type":"unknown","description":"Always `null` for this endpoint."}