Skip to main content
GET
Creator Card

Authorizations

Authorization
string
header
required

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

Path Parameters

creator_id
string
required
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

id
string
required
youtube_channel_id
string
required
first_seen_at
string<date-time>
required
is_stale
boolean
required

True when no metrics snapshot exists within the selected date range and the values shown fall back to the creator's last known snapshot.

influence_score
Metric · object
required
is_shortlisted
boolean
required
display_name
string | null
handle
string | null
channel_url
string | null
channel_description
string | null
thumbnail_url
string | null
channel_publish_date
string<date> | null
country
string | null
channel_type
string | null
channel_attributes
string[] | null
last_updated_at
string<date-time> | null

Captured-at timestamp of the resolved metrics snapshot currently backing the displayed metrics.

tier_type
enum<string> | null

Creator tier derived from subscriber_count (Nano < 100k, Micro < 500k, Mid-Tier < 1M, Macro >= 1M). None when subscriber_count is unavailable.

Available options:
Nano,
Micro,
Mid-Tier,
Macro
shortlist_id
string | null

Id of the workspace shortlist entry when is_shortlisted is true.

partnership_opportunities
enum<string>[] | null

Brand-partnership opportunity tags from the resolved snapshot (Google Ads' PartnershipOpportunityType enum), sourced the same way as every other snapshot field.

Google Ads' PartnershipOpportunityType enum (ContentCreatorInsightsService) -- the possible tags in CreatorMetricsSnapshot.partnership_opportunities. Owned by Google, not this codebase: if a new value ships before this list is updated, a snapshot carrying it will fail response validation (accepted tradeoff, see youtube-creator-insights spec §5.5).

Available options:
CREATOR_PARTNERSHIPS,
CREATOR_TAKEOVER,
PARTNERSHIP_ADS,
UNKNOWN,
UNSPECIFIED,
YOUTUBE_SELECT_LINEUPS
subscriber_count
Metric · object | null
video_count
Metric · object | null

Distinct cited videos for this creator within the active filter scope, not the channel's total video count.

view_count
Metric · object | null
likes_count
Metric · object | null
comments_count
Metric · object | null
engagement_rate
Metric · object | null
average_views_per_video
Metric · object | null
average_likes_per_video
Metric · object | null
average_comments_per_video
Metric · object | null
is_active_shorts_creator
boolean | null
language_distributions
LanguageDistributionResponse · object[] | null

Channel content language mix from the Insights API. Creator Card only.

audience_age_ranges
Audience Age Ranges · object | null

Audience age-band proportions from the resolved metrics snapshot. Creator Card only.

audience_genders
Audience Genders · object | null

Audience gender proportions from the resolved metrics snapshot. Creator Card only.

audience_countries
Audience Countries · object | null

Audience country proportions from the resolved metrics snapshot. Creator Card only.

top_videos
CreatorTopVideoResponse · object[] | null

The channel's own top videos from the Insights API for the resolved snapshot. Informational only — not the same as cited videos. Creator Card only.