List Articles
Returns a paginated list of live articles ordered by publication date (newest first). Each article includes an English headline, a short summary, and key points, with article_url linking to the full original-language article at the source. Supports filtering by country, category, source, company ticker, and content type. Use GET /api/v1/sources to discover source IDs for the sources filter. Use updated_after for incremental syncing, or q for full-text search ranked by relevance. Use ids for batch lookup of specific articles. Responses include cursor-based pagination and support field projection to minimize payload size.
Authorizations
API Key authentication using Bearer token
Query Parameters
Number of articles to return per page (default 25, max 100).
Opaque pagination cursor returned as pagination.next_cursor from a previous response. Mutually exclusive with q.
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.
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.
Full-text search query (2-200 characters). Results are ranked by relevance instead of publication date. Mutually exclusive with cursor. Disables caching.
Filter by country using ISO 3166-1 alpha-2 code (e.g. SE, NO, DK). Comma-separated for multiple (e.g. SE,NO). Case-insensitive.
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.
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.
Filter to a single company by its id (as returned by the companies endpoints). Complements ticker; use this to reach companies without a stock listing.
Filter by exchange using ISO 10383 Market Identifier Code (e.g. XSTO for Nasdaq Stockholm, XCSE for Nasdaq Copenhagen, XHEL for Nasdaq Helsinki, XOSL for Oslo Børs). Returns articles about companies actively listed there. Case-insensitive.
Filter by stock index id or symbol (e.g. OMXS30, OMXC25, OMXH25, OBX). Returns articles about companies in that index. Case-insensitive for symbols.
Filter by company sector. Case-sensitive; must exactly match one of: Communication Services, Consumer Discretionary, Consumer Staples, Energy, Financials, Health Care, Industrials, Information Technology, Materials, Real Estate, Utilities.
Filter by article content type.
news, analysis, press_release, market_commentary, market_news, trading_halt, trading_event, other ISO 8601 datetime. Returns articles published on or after this timestamp.
ISO 8601 datetime. Returns articles published before this timestamp.
When true, only return articles mentioning at least one publicly listed company.
Restricts to articles mentioning companies in a single watchlist, identified by its id (from the List Watchlists endpoint). An unknown id returns no articles. Requires read:watchlist scope.
Comma-separated list of article IDs for batch lookup (max 100). Cannot be combined with cursor or updated_after.