NOnordicfinancialnews
Companies

List Company Articles

Returns articles where the company is a principal association (subject, partner, investor, or competitor), ordered by publication date (newest first). An article where this company is only the source, an advisor, or a passing mention is excluded.

Parameters

Accepts the same q, sort, fields, updated_after, country, category, sources, source_type, content_type, published_after and published_before parameters as GET /api/v1/articles, with identical semantics, scoped to this company. primary_only=true narrows further within that principal set, to only articles where this company is the primary subject.

Rejected parameters

ticker, company, watchlist, listed, exchange, market, domicile, index, sector and market_segment are rejected (400). The path already fixes the company; use GET /api/v1/articles to filter the full collection by them (watchlist=false and listed with any value other than true are ignored, as on the flat resource).

Caching

Requests with updated_after are not cached: they return Cache-Control: no-cache, no-store and no ETag. The ETag reflects the response as served, not only record timestamps: it changes when plan limits alter the visible set, so a changed ETag does not necessarily mean a record was updated.

get/api/v1/companies/{identifier}/articles

Request

Query parameters

limitinteger

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

cursorstring

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

fieldsstring

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_afterstring

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.

qstring

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'relevance' | 'latest'

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.

countrystring

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.

categorystring

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

sourcesstring

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_typestring

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_typestring

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_afterstring

ISO 8601 datetime, or YYYY-MM-DD for 00:00 UTC. Returns articles published on or after this timestamp.

published_beforestring

ISO 8601 datetime, or YYYY-MM-DD for 00:00 UTC. Returns articles published before this timestamp.

primary_onlyboolean

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

include_peripheralboolean

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.

Headers

If-None-Matchstring

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

If-Modified-Sincestring

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

Response

Company articles retrieved successfully

plan_limitedboolean

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 response

{
  "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",
      "updated_at": "2026-03-15T09:35:00.000Z",
      "category": {
        "id": "cat_earnings1",
        "name": "Earnings & Financial Results"
      },
      "source": {
        "id": "abc123def456",
        "name": "Dagens Industri",
        "domain": "di.se",
        "source_type": "news_publication"
      },
      "company_ids": [
        "uejazctgchj4"
      ],
      "country": "SE",
      "event_id": "8fzq2rmtnk5c"
    }
  ],
  "plan_limited": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.