Skip to main content
GET
List viral content

Authorizations

Authorization
string
header
required

A workspace API key.

Query Parameters

platform
enum<string>

Restrict to one platform.

Available options:
youtube_shorts,
instagram_reels,
tiktok,
twitter,
reddit,
news
niche
string

Restrict to one niche.

Required string length: 1 - 200
Example:

"personal finance"

themeId
string

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

Required string length: 1 - 160
Example:

"iab:3.1:391"

format
string

Restrict to one content format.

Required string length: 1 - 100
Example:

"talking-head"

minScore
number

Drop anything scoring below this. 0–100.

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

70

sortBy
enum<string>

What to order by. Defaults to virality score.

Available options:
viralityScore,
collectedAt,
metrics.views
sortDirection
enum<string>
default:desc

Order direction.

Available options:
asc,
desc
limit
integer
default:50

How many items to return. Between 1 and 100; defaults to 50.

Required range: 1 <= x <= 100

Response

Success.

success
boolean
required
{key}
any