Skip to main content
GET
List trends, topics, and breakouts (Beta)

Authorizations

X-API-Key
string
header
required

Query Parameters

card_type
enum<string> | null
Available options:
trend_moment,
topic,
entity_breakout
lifecycle
string | null

Filter by lifecycle state (e.g. rising).

program
string
default:general_market

Production market catalog.

Allowed value: "general_market"
persona
string | null

Filter to cards serving this audience persona key.

entity
string | null

Filter to cards featuring this brand, retailer, or product.

brand_safety
string | null

Filter by brand-safety assessment (e.g. safe).

platform
string | null

Filter by source platform (e.g. tiktok).

min_size
integer | null

Minimum number of videos on the item.

Required range: x >= 1
since
string<date-time> | null

Only items refreshed at or after this time.

sort
enum<string>
default:rising

Ranking mode. Rising orders items accelerating relative to their own recent baseline. The legacy momentum value remains accepted.

Available options:
rising,
momentum,
newest,
value,
freshness,
size
limit
integer
default:25
Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset.

Required range: x >= 0

Response

Successful Response

items
RadarItem · object[]
required

Items matching the query.

beta
string
default:Beta: response shapes may change and this surface may converge with /v2/trends.

Beta status caveat.

total
integer | null

Total items matching the filters, across all pages.