Skip to main content
GET
/
api
/
v1
/
categories
/
{public_id}
/
stories
List category stories
curl --request GET \
  --url http://localhost:3000/api/v1/categories/{public_id}/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

public_id
string
required

Category ID

Query Parameters

limit
integer

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

cursor
string

Opaque pagination cursor from a previous response.

updated_after
string

ISO 8601 datetime. Returns only stories updated after this timestamp.

Response

Category stories retrieved successfully

stories
object[]
required
pagination
object