Get Creator by ID
Get a creator’s profile using their stable Upriver creator ID. If the ID has been merged into another creator, the response includes a redirect object in the JSON body and the X-Creator-Redirect header. Clients should update any stored creator ID to redirect.canonical_creator_id.
Optional Expansions (include parameter):
engagement_metrics: Average views, likes, comments from recent content. See Metrics Guide for calculation details and platform coverage.video_metrics: Trailing 12-week ad inventory metrics. Includes uploads per week plus optional duration stats and coverage metadata (lookback_weeks,weeks_observed,window_complete). Duration fields are omitted when no uploads fall inside the 12-week window. See Metrics Guide for details.relative_metrics: Public benchmark summaries relative to similar creators. Benchmarks use the channel’s follower bucket and, when available, a stable content category.bio: Biographical summary and key facts about the creatoraudience: Directional audience demographics (age, gender, geography). Age includes a directional range plus optional explicit percentage segments (which may be partial).brand_safety: Brand safety advisories with source citations
Always returned:
creator_id: Universal stable creator ID, present for any successful creator responsechannels[].channel_relationship: Only present for non-primary channels. ‘attached’ = a distinct show/brand/project surface tied to the creator; ‘group’ = a shared or collab surface the creator is part of
Authorizations
Path Parameters
Query Parameters
Optional expansions to include in the response. Allowed values: engagement_metrics, video_metrics, relative_metrics, bio, audience, brand_safety, creator_id. creator_id is accepted as a backward-compatible no-op because the field is now always returned. For /creators/search, include expansions are supported only for exact creator_url lookups. Broad query mode (query/creator_name without creator_url) returns lightweight results without expansions. Use /creators or /creators/{creator_id} to enrich a selected result. video_metrics returns trailing 12-week inventory metrics. relative_metrics returns public benchmark summaries relative to similar creators. Examples: include=engagement_metrics&include=bio or include=engagement_metrics,bio
Response
Canonical creator payload. When a previously stored creator ID has been merged into another creator, the response still returns HTTP 200 with the canonical creator body, a redirect object in the JSON payload, and an X-Creator-Redirect response header.
Response returned by the creator get endpoint.
Biographical summary of the creator. Only present when include=bio is specified.
Social media channels for the creator across supported platforms.
Descriptive labels for the creator. Includes stable categories (type='category', use for filtering) and dynamic tags (type='tag'). See /media_categories for the full category taxonomy.
DEPRECATED: Use 'labels' instead. This field will be removed in a future version.
Stable Upriver creator ID. Present for any successful creator response, including provisional single-platform creators. Store and reuse this ID for consistency across API calls.
Present when the requested creator_id has been merged into another creator. Clients should update any stored ID to redirect.canonical_creator_id.
{
"canonical_creator_id": "cb4f53f0-c905-4c0a-86df-9a6c7551c408",
"reason": "merged",
"requested_creator_id": "97ca4d8c-c1b2-4c73-a4f0-7ac6bb05e0cf"
}
Directional audience demographics. Only present when include=audience is specified. age.min_age/max_age is a directional envelope; age.segments contains explicit percentage buckets and may be partial.