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,
facebook_reels,
tiktok,
twitter,
reddit,
news,
medium,
google_news,
google_web
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
items
object[]
required

Observed content matching the filters.

hasMore
boolean
required

True when the bounded query found more items than returned.

nextCursor
null
required

Always null until stable cursor pagination is available.

{key}
any