Skip to main content
GET
/
api
/
v1
/
companies
/
{identifier}
/
articles
List company articles
curl --request GET \
  --url http://localhost:3000/api/v1/companies/{identifier}/articles \
  --header 'Authorization: Bearer <token>'
{
  "articles": [
    {
      "id": "art_abc123def",
      "title": "Title",
      "title_en": "Title",
      "summary_en": "Summary",
      "article_url": "https://example.com/articles/abc123def",
      "content_type": "news",
      "published_at": "2023-11-07T05:31:56Z",
      "category": {
        "id": "<string>",
        "name": "<string>"
      },
      "source": {
        "name": "Source Name",
        "domain": "example.com"
      },
      "story_ids": [
        "<string>"
      ],
      "companies": [
        {
          "id": "<string>",
          "name": "<string>",
          "ticker_symbol": "<string>"
        }
      ],
      "country": "SE",
      "image_url": "<string>"
    }
  ],
  "pagination": {
    "count": 123,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Headers

Authorization
string
required

Bearer token for authentication

Path Parameters

identifier
string
required

Company ID or ticker symbol

Query Parameters

limit
integer

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

cursor
string

Opaque pagination cursor from a previous response.

primary_only
boolean

When true, only return articles where this company is the primary subject (not just mentioned).

Response

200 - application/json

Company articles retrieved successfully

articles
object[]
required
pagination
object