Skip to main content
GET
List narratives

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

Free text over name and description.

sector
string

GICS sector name.

tickers
string

Comma-separated tickers to scope by.

countries
string

Comma-separated ISO alpha-2 issuer domiciles to scope by (e.g. AE,SA,QA,KW).

ciks
string

Comma-separated issuer platform keys to scope by.

includeDormant
enum<string>

1 to include themes with no activity in the trailing window (returned as lifecycleState=dormant).

Available options:
1
minBreadth
integer

Minimum companies discussing the theme (signal floor). 0 = long tail.

source
enum<string>

all | companies | policy.

Available options:
all,
companies,
policy
sort
enum<string>

relevance | breadth | momentum | recent.

Available options:
relevance,
breadth,
momentum,
recent
limit
integer

Page size (max 200).

offset
integer

Offset.

Response

OK

The response is of type object.