Skip to main content
GET
List Company Articles

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Headers

If-None-Match
string

ETag value from a previous response. Returns 304 Not Modified if data has not changed.

If-Modified-Since
string

HTTP date from a previous Last-Modified header. Returns 304 Not Modified if nothing has changed since.

Path Parameters

identifier
string
required

Company ID or ticker symbol. Accepts the exchange-suffixed form (e.g. VOLV-B.ST); former tickers resolve too. When a ticker is shared by more than one company, the company with a listing on a Nordic exchange is returned, then the one with an active listing, then the most recently listed. Use the company ID for an unambiguous lookup.

Query Parameters

limit
integer

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

cursor
string

Opaque pagination cursor from a previous response. Mutually exclusive with q unless sort=latest is also given.

fields
string

Comma-separated list of fields to include in the response. Reduces payload size. Available fields: id, title, article_url, published_at, updated_at, content_type, source, company_ids, country, category.

updated_after
string

ISO 8601 datetime. Returns only this company's articles updated after this timestamp. Use this for incremental sync: store the timestamp of your last completed sync, then request only newer results on each poll. Results are ordered by updated_at ascending and are cursor-paginated. Follow pagination.next_cursor, resending the same updated_after value, until it is null. Only advance your stored timestamp once you have drained every page. Mutually exclusive with sort=latest (with or without q). An updated_after walk is always ordered by updated_at.

q
string

Full-text search query (2-200 characters). By default, results are ranked by relevance instead of publication date, as a single page with no cursor. Mutually exclusive with cursor unless sort=latest is also given. Disables caching.

sort
enum<string>

Result order for q. relevance (default) is a single relevance-ranked page with no cursor; it requires q, and returns 400 without one. latest turns q into a match filter under the endpoint's normal newest-first order (published_at descending) and the response is cursor-paginated like any other request; without q it is an accepted no-op (that's already the default order). Mutually exclusive with updated_after.

Available options:
relevance,
latest
country
string

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.

category
string

Filter by category id (from GET /api/v1/categories). Comma-separated for multiple (e.g. cat_earnings1,cat_mna000001); unknown ids are ignored.

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.

source_type
string

Filter by source type, comma-separated. Valid values: news_publication, wire_service, press_release, government, trade_publication, blog, stock_exchange, research. Articles from disabled sources are excluded. An unrecognized value returns 400 naming the bad value(s).

content_type
string

Filter by article content type, comma-separated. Valid values: news, analysis, press_release, market_commentary, market_news, trading_halt, trading_event, other. GET /api/v1/meta lists them as content_types. An unrecognized value returns 400 naming the bad value(s).

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.

primary_only
boolean

When true, narrows further within the already-principal match, to only articles where this company is the primary subject.

include_peripheral
boolean

When true, widen this feed back to articles where the company is only a peripheral association (its source, an advisor, or a passing mention), which are otherwise excluded. Default false (principal-only). primary_only still keeps the primary-subject restriction even when peripheral is requested.

Response

Company articles retrieved successfully

articles
object[]
required
pagination
object
plan_limited
boolean

Present and true when your plan restricted what this endpoint can return, so the result may be incomplete. Absent when your plan applies no restriction.

Example:

true

Last modified on October 7, 2026