Search

Search

Search across articles, stories, companies, countries, exchanges, and indices. Results are grouped by resource type and ranked by relevance. Use type to limit which resource types are searched.

get/api/v1/search

Request

Query parameters

qstring required

Full-text search query (2-200 characters).

typestring

Comma-separated list of resource types to search. Defaults to all types. Valid values: articles, stories, companies, countries, exchanges, indices.

limitinteger

Maximum number of results per resource type (default 5, max 25).

Response

Search results

Example response

{
  "results": {
    "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"
      }
    ],
    "stories": [
      {
        "id": "story_volvo_q3",
        "title": "Volvo Reports Record Q3 Results",
        "summary": "Volvo reported record third-quarter earnings, beating analyst expectations...",
        "article_count": 4,
        "published_at": "2026-03-15T09:30:00.000Z",
        "updated_at": "2026-03-15T09:35:00.000Z",
        "article_ids": [
          "art_abc123def",
          "art_def456ghi"
        ],
        "country": "SE",
        "company_ids": [
          "uejazctgchj4"
        ],
        "event_id": "8fzq2rmtnk5c"
      }
    ],
    "companies": [
      {
        "id": "w55fcw3pbg3p",
        "name": "Volvo Car AB",
        "slug": "VOLCAR-B",
        "ticker": "VOLCAR-B",
        "former_tickers": [
          "VOLV"
        ],
        "is_active": true,
        "market_segment": "large_cap",
        "also_listed_on": []
      }
    ],
    "countries": [
      {
        "id": "ctry_sweden12",
        "name": "Sweden",
        "iso2_code": "SE"
      }
    ],
    "exchanges": [
      {
        "id": "exch_nasdaq1",
        "name": "Nasdaq Stockholm",
        "mic_code": "XSTO",
        "acronym": "NASDAQ"
      }
    ],
    "indices": [
      {
        "id": "idx_omxs30abc",
        "name": "OMX Stockholm 30",
        "symbol": "OMXS30"
      }
    ]
  }
}

Changes

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