Skip to main content
GET
Creator Stats Summary

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

date_start
string<date> | null

Start of the date range (YYYY-MM-DD).

date_end
string<date> | null

End of the date range (YYYY-MM-DD).

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

total_creators
integer
required

Count of creators matching the active filters.

creators_with_partnership_ads
integer
required

Count of those creators whose resolved snapshot's partnership_opportunities contains 'PARTNERSHIP_ADS'.

creators_by_tier
Creators By Tier · object
required

Count of creators grouped by tier (nano/micro/mid_tier/macro), plus an explicit 'unknown' bucket for creators with no resolvable subscriber_count. Always sums to total_creators.