Skip to main content
GET
/
api
/
v1
/
countries
/
{identifier}
/
stories
List country stories
curl --request GET \
  --url http://localhost:3000/api/v1/countries/{identifier}/stories \
  --header 'Authorization: Bearer <token>'
{
  "stories": [
    {
      "id": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "article_count": 123,
      "published_at": "2023-11-07T05:31:56Z",
      "article_ids": [
        "<string>"
      ],
      "country": "<string>",
      "topics": [
        "<string>"
      ],
      "companies": [
        {
          "id": "<string>",
          "name": "<string>",
          "ticker_symbol": "<string>"
        }
      ],
      "category": {
        "id": "<string>",
        "name": "<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 stories 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 stories updated after this timestamp.

Response

200 - application/json

Country stories retrieved successfully

stories
object[]
required
pagination
object