Get headlines (topics list)
GET
/topics
Retrieve a paginated list of topics/headlines with optional filters
Authorizations
ApiKeyAuth
API key authentication. Format: cp_{env}v1{random}_{checksum}. Example: cp_prod_v1_xxxxxxxxxx_xx
Type
API Key (header: CP-X-API-KEY)
Parameters
Query Parameters
category
Filter by category (0=Breaking, 1=Important, 2=Normal)
Type
integer
Valid values
012Example
0page
Page number
Type
integer
Example
1Minimum
1Default
1page_size
Number of items per page
Type
integer
Example
20Minimum
1Default
20lang
Language code
Type
string
Valid values
"en""ja""zh"Example
"en"Default
"en"filter
Filter topics where the selected boolean field is true
Type
string
Valid values
"financial""crypto"Example
"crypto"publish_before
Filter by topics published before this date (RFC3339 format)
Type
string
Example
"2026-03-12T09:45:44Z"Format
"date-time"publish_after
Filter by topics published after this date (RFC3339 format)
Type
string
Example
"2026-03-10T09:45:44Z"Format
"date-time"Responses
Successful response
application/json
JSON "code": 0, "message": "ok", "data": [ { "id": 1, "title": "Bitcoin hits new high", "subtitle": "crypto", "summary": "market analysis summary", "summary_bullets": [ [ "Bitcoin reached a new high", "Trading volume increased", "Market sentiment remained bullish" ] ], "category": 0, "lang": "en", "published_at": "2026-01-01T10:00:00Z", "url": "https://coinpost.ai/topics/1" } ], "total": 100
{
}