Get headlines (topics list)
GET
/topics
Retrieve a paginated list of topics/headlines with optional filters
認証
ApiKeyAuth
API key authentication. Format: cpt_{env}v1{random}_{checksum}. Example: cpt_prod_v1_xxxxxxxxxx_xx
型
API Key (header: X-CP-TERMINAL-API-KEY)
パラメータ
クエリパラメータ
category
Filter by category (0=Breaking, 1=Important, 2=Normal)
型
integer
有効な値
012例
0page
Page number
型
integer
例
1最小値
1デフォルト
1page_size
Number of items per page
型
integer
例
20最小値
1デフォルト
20lang
Language code
型
string
有効な値
"en""ja""zh"例
"en"デフォルト
"en"publish_before
Filter by topics published before this date (RFC3339 format)
型
string
例
"2026-03-12T09:45:44Z"フォーマット
"date-time"publish_after
Filter by topics published after this date (RFC3339 format)
型
string
例
"2026-03-10T09:45:44Z"フォーマット
"date-time"レスポンス
Successful response
application/json
JSON "code": 0, "message": "ok", "data": [ { "id": 1, "title": "Bitcoin hits new high", "subtitle": "crypto", "summary": "market analysis summary", "category": 0, "lang": "en", "published_at": "2026-01-01T10:00:00Z", "url": "https://coinpost.ai/topics/1" } ], "total": 100
{
}