Sources

List Sources

Returns a paginated list of enabled news sources, ordered alphabetically by name. Use source IDs to filter articles and stories via the sources parameter on the articles and stories list endpoints.

get/api/v1/sources

Request

Query parameters

limitinteger

Number of sources to return per page (default 25, max 100).

cursorstring

Opaque pagination cursor from a previous response.

fieldsstring

Comma-separated list of fields to include. Available fields: id, name, domain, country, source_type.

Headers

If-None-Matchstring

ETag value from a previous response. Returns 304 Not Modified if data has not changed.

If-Modified-Sincestring

HTTP date from a previous Last-Modified header. Returns 304 Not Modified if nothing has changed since.

Response

Sources retrieved

Example response

{
  "sources": [
    {
      "id": "abc123def456",
      "name": "Dagens Industri",
      "domain": "di.se",
      "country": "SE",
      "source_type": "news_publication"
    }
  ],
  "pagination": {
    "count": 25
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.