List viral content
Signals
List viral content
List scored viral content with canonical theme assignments. Every item carries a primary theme, ancestor ids, confidence, provenance and the joined theme economics/risk prior. Filtering uses canonical theme ids, not provider-specific category labels.
GET
List viral content
Authorizations
A workspace API key.
Query Parameters
Restrict to one platform.
Available options:
youtube_shorts, instagram_reels, tiktok, twitter, reddit, news Restrict to one niche.
Required string length:
1 - 200Example:
"personal finance"
Restrict to one canonical theme. GET /v1/themes lists them.
Required string length:
1 - 160Example:
"iab:3.1:391"
Restrict to one content format.
Required string length:
1 - 100Example:
"talking-head"
Drop anything scoring below this. 0–100.
Required range:
0 <= x <= 100Example:
70
What to order by. Defaults to virality score.
Available options:
viralityScore, collectedAt, metrics.views Order direction.
Available options:
asc, desc How many items to return. Between 1 and 100; defaults to 50.
Required range:
1 <= x <= 100