Creator Card
A single creator’s full profile: the same period-scoped score, metrics, staleness, and shortlist fields as the Creator List row, plus enrichment-only language mix, audience breakdowns, and the channel’s own top videos from the resolved metrics snapshot. Profile fields (display name, handle, channel URL, etc.) are always returned regardless of filters. Influence Score and metrics narrow to the same country/engine/brand/category/analysis/persona/date-range filters as the Creator List (R22). Defaults to the last month when no date range is given.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Start of the date range (YYYY-MM-DD).
End of the date range (YYYY-MM-DD).
Filter by engine.
Bing, BingAIO, ChatGPT, Perplexity, Google, GoogleAIO, GoogleAIMode, Claude, Gemini, AmazonRufus, Grok, Copilot, Mistral Filter by a list of persona IDs.
Filter by country.
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 Filter by brand.
Filter by category.
Filter by analysis (project) ID.
Response
Successful Response
True when no metrics snapshot exists within the selected date range and the values shown fall back to the creator's last known snapshot.
Captured-at timestamp of the resolved metrics snapshot currently backing the displayed metrics.
Creator tier derived from subscriber_count (Nano < 100k, Micro < 500k, Mid-Tier < 1M, Macro >= 1M). None when subscriber_count is unavailable.
Nano, Micro, Mid-Tier, Macro Id of the workspace shortlist entry when is_shortlisted is true.
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).
CREATOR_PARTNERSHIPS, CREATOR_TAKEOVER, PARTNERSHIP_ADS, UNKNOWN, UNSPECIFIED, YOUTUBE_SELECT_LINEUPS Distinct cited videos for this creator within the active filter scope, not the channel's total video count.
Channel content language mix from the Insights API. Creator Card only.
Audience age-band proportions from the resolved metrics snapshot. Creator Card only.
Audience gender proportions from the resolved metrics snapshot. Creator Card only.
Audience country proportions from the resolved metrics snapshot. Creator Card only.
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.