Skip to main content
GET
List trends

Authorizations

Authorization
string
header
required

A workspace API key.

Query Parameters

platform
enum<string>

Restrict to one platform.

Available options:
youtube_shorts,
instagram_reels,
facebook_reels,
tiktok,
twitter,
reddit,
news,
medium,
google_news,
google_web
themeId
string

Restrict to one canonical theme. GET /v1/themes lists them.

Required string length: 1 - 160
Example:

"iab:3.1:391"

windowHours
integer
default:72

How far back to look. 1 hour to 30 days; defaults to 72 hours.

Required range: 1 <= x <= 720
minScore
number

Drop signals scoring below this. 0–100.

Required range: 0 <= x <= 100
Example:

60

minEvidence
integer
default:1

How many independent observations a signal needs before it is returned.

Required range: 1 <= x <= 20
limit
integer
default:20

How many signals to return. Between 1 and 50; defaults to 20.

Required range: 1 <= x <= 50

Response

Success.

success
boolean
required

Signals ordered by score and recency.

freshness
object
required

How current the evidence is.

coverage
object
required

What the aggregation sampled and what it does not claim.

{key}
any