Skip to main content
GET
/
api
/
v1
/
articles
List Articles
curl --request GET \
  --url https://nordicfinancialnews.com/api/v1/articles \
  --header 'Authorization: Bearer <token>'
{
  "articles": [
    {
      "id": "art_abc123def",
      "title": "Volvo Reports Record Q3 Earnings",
      "article_url": "https://di.se/articles/volvo-q3-2026",
      "content_type": "news",
      "published_at": "2026-03-15T09:30:00.000Z",
      "category": {
        "id": "cat_earnings1",
        "name": "Earnings & Financial Results"
      },
      "source": {
        "id": "abc123def456",
        "name": "Dagens Industri",
        "domain": "di.se"
      },
      "company_ids": [
        "uejazctgchj4"
      ],
      "country": "SE"
    }
  ],
  "pagination": {
    "count": 25,
    "next_cursor": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.nordicfinancialnews.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API Key authentication using Bearer token

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, article_url, published_at, content_type, source, company_ids, country, category.

​
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 https://docs.nordicfinancialnews.com). 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).

​
sources
string

Comma-separated list of source IDs (max 25). Use GET /api/v1/sources to discover source IDs. Also accepts array form (sources[]=id1&sources[]=id2). Disabled sources resolve to empty results.

​
ticker
string

Filter by company stock ticker symbol (e.g. VOLV-B). Accepts full tickers with exchange suffix (e.g. VOLV-B.ST). 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.

​
listed
string

When true, only return articles mentioning at least one publicly listed company.

​
watchlist
string

When true, only return articles mentioning companies in the authenticated user's watchlist. Requires read:watchlist scope.

​
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
​
pagination
object
Last modified on April 20, 2026