Skip to main content
GET
/
api
/
v1
/
countries
/
{identifier}
/
articles
List country articles
curl --request GET \
  --url http://localhost:3000/api/v1/countries/{identifier}/articles \
  --header 'Authorization: Bearer <token>'
{
  "articles": [
    {
      "id": "art_abc123def",
      "title": "Title",
      "title_en": "Title",
      "summary_en": "Summary",
      "article_url": "https://example.com/articles/abc123def",
      "content_type": "news",
      "published_at": "2023-11-07T05:31:56Z",
      "category": {
        "id": "<string>",
        "name": "<string>"
      },
      "source": {
        "name": "Source Name",
        "domain": "example.com"
      },
      "story_ids": [
        "<string>"
      ],
      "companies": [
        {
          "id": "<string>",
          "name": "<string>",
          "ticker_symbol": "<string>"
        }
      ],
      "country": "SE",
      "image_url": "<string>"
    }
  ],
  "pagination": {
    "count": 123,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Headers

Authorization
string
required

Bearer token for authentication

Path Parameters

identifier
string
required

Country ID, ISO 3166-1 alpha-2 code (e.g. SE), or slug (e.g. sweden)

Query Parameters

limit
integer

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

cursor
string

Opaque pagination cursor from a previous response.

updated_after
string

ISO 8601 datetime. Returns only articles updated after this timestamp.

fields
string

Comma-separated list of fields to include in the response.

Response

200 - application/json

Country articles retrieved successfully

articles
object[]
required
pagination
object