Skip to main content
GET
Search news

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Query Parameters

q
string
required

Required. Search text (websearch syntax), at most 200 characters (longer is cut).

limit
integer
default:50

Items per page, 1–100, default 50; above 100 is a 400.

Required range: 1 <= x <= 100
tickers
string

Comma-separated tickers; items tagged with any of them.

cik
string

Numeric CIK or platform key; items whose primary company or a tagged company entity is this issuer.

topics
string

Comma-separated topic codes (see /news/topics); any of them.

sources
string

Comma-separated source codes (see /news/sources); any of them.

excludeSources
string

Comma-separated source codes to hide (the UI's Markets view hides agency releases, social posts and GDELT links).

excludeForms
string

Comma-separated filing form types to hide (e.g. 4,144,SC 13G); rows without a form are kept.

flash
enum<string>

1 to return flash (high-priority) items only; 0 (default) for all.

Available options:
0,
1,
true,
false
minImportance
integer

Minimum importance score 0–100.

Required range: 0 <= x <= 100
before
integer<int64>

Load older: items published before item on the tape (by publication time, then id). Pass the previous response's nextCursor.

Response

OK

items
object[]
required

Newest first.

nextCursor
integer<int64> | null
required

Pass as before= for the next page; null when exhausted.