Skip to main content
GET
Video Activity Timeline

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organization_id
string
required
workspace_id
string
required

Query Parameters

sources
enum<string>[] | null

Filter by engine.

Available options:
Bing,
BingAIO,
ChatGPT,
Perplexity,
Google,
GoogleAIO,
GoogleAIMode,
Claude,
Gemini,
AmazonRufus,
Grok,
Copilot,
Mistral
persona_ids
string[] | null

Filter by a list of persona IDs.

countries
enum<string>[] | null

Filter by country.

Available options:
AR,
AT,
AU,
AE,
BH,
BE,
BO,
BR,
CA,
CN,
CO,
CR,
DK,
DO,
EC,
ES,
FI,
FR,
DE,
GB,
GT,
HK,
HU,
ID,
IE,
IL,
IN,
IT,
JP,
KR,
KW,
LU,
MA,
MX,
MY,
NG,
NL,
NO,
NZ,
PA,
PH,
PK,
PL,
PT,
QA,
RO,
SA,
SE,
SG,
CH,
TH,
TR,
TW,
US,
VN,
ZA
brands
string[] | null

Filter by brand.

categories
string[] | null

Filter by category.

project_ids
string[] | null

Filter by analysis (project) ID.

Response

Successful Response

months
VideoActivityMonthResponse · object[]
required

Trailing 12 calendar months ending now, oldest first.

total_videos_count
integer
required

Distinct videos active anywhere in the 12-month window (a union across months, not a sum).