Skip to main content
GET
/
api
/
v1
/
articles
List articles
curl --request GET \
  --url http://localhost:3000/api/v1/articles \
  --header 'Authorization: Bearer <token>'
{
  "articles": [
    {
      "id": "<string>",
      "title": "<string>",
      "title_en": "<string>",
      "summary_en": "<string>",
      "article_url": "<string>",
      "content_type": "news",
      "published_at": "2023-11-07T05:31:56Z",
      "story_ids": [
        "<string>"
      ],
      "category": {
        "id": "<string>",
        "name": "<string>"
      },
      "source": {
        "name": "<string>",
        "domain": "<string>"
      },
      "companies": [
        {}
      ],
      "country": "<string>",
      "image_url": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API Key authentication using Bearer token

Headers

​
Authorization
string
required

Bearer token for authentication

Query Parameters

​
limit
integer

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

​
cursor
string

Opaque pagination cursor returned as pagination.next_cursor from a previous response. Mutually exclusive with q.

​
fields
string

Comma-separated list of fields to include in the response. Reduces payload size. Available fields: id, title, title_en, summary_en, article_url, content_type, published_at, story_ids, source, companies, country, category, image_url.

​
updated_after
string

ISO 8601 datetime. Returns only articles updated after this timestamp. Use this for polling-based real-time updates: store the timestamp of your last sync, then request only newer results on each poll (see the Real-Time Updates guide at /api-docs). Disables cursor pagination — all matching results are returned in a single response.

​
q
string

Full-text search query (2-200 characters). Results are ranked by relevance instead of publication date. Mutually exclusive with cursor. Disables caching.

​
country
string

Filter by country using ISO 3166-1 alpha-2 code (e.g. SE, NO, DK).

​
ticker
string

Filter by company stock ticker symbol. Returns articles mentioning the company.

​
content_type
enum<string>

Filter by article content type.

Available options:
news,
analysis,
press_release,
market_commentary,
market_news,
trading_halt,
trading_event,
other
​
published_after
string

ISO 8601 datetime. Returns articles published on or after this timestamp.

​
published_before
string

ISO 8601 datetime. Returns articles published before this timestamp.

​
ids
string

Comma-separated list of article IDs for batch lookup (max 100). Cannot be combined with cursor or updated_after.

Response

Articles retrieved successfully

​
articles
object[]
required