Skip to main content
GET
/
api
/
v1
/
companies
/
{identifier}
/
stories
List company stories
curl --request GET \
  --url http://localhost:3000/api/v1/companies/{identifier}/stories \
  --header 'Authorization: Bearer <token>'
{
  "stories": [
    {
      "id": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "article_count": 123,
      "published_at": "2023-11-07T05:31:56Z",
      "article_ids": [
        "<string>"
      ],
      "country": "<string>",
      "topics": [
        "<string>"
      ],
      "companies": [
        {
          "id": "<string>",
          "name": "<string>",
          "ticker_symbol": "<string>"
        }
      ],
      "category": {
        "id": "<string>",
        "name": "<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 stories to return per page (default 25, max 100).

cursor
string

Opaque pagination cursor from a previous response.

Response

200 - application/json

Company stories retrieved successfully

stories
object[]
required
pagination
object