Creators

Search

Unified creator search for exact, broad, and filter-only queries.

Exact lookup: Provide creator_url (or an exact query) to quickly find the creator and linked channels.

Broad discovery: Provide query with optional filters (platforms, category_ids, follower_bucket, follower range, country/language).

Filter-only browse: Provide category_ids + follower_bucket without a text query to browse creators by category and size.

Pass next_cursor from any search response back as cursor with the same query and filters to fetch the next page.

Use the include query parameter for optional expansions. In /creators/search, include expansions are supported only for exact creator_url lookups.

POST

creators

curl --request POST \
  --url https://api.upriver.ai/v1/creators/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "creator_url": "https://www.youtube.com/@MrBeast",
  "name_or_handle": "MrBeast",
  "creator_name": "MrBeast",
  "query": "@mkbhd",
  "limit": 10,
  "platforms": [
    "youtube",
    "tiktok"
  ],
  "category_ids": [
    "technology",
    "tech_news_lifestyle"
  ],
  "categories": [
    "gaming and esports",
    "AI tools"
  ],
  "min_followers": 10000,
  "max_followers": 5000000,
  "follower_bucket": [
    "10k_50k",
    "50k_100k"
  ],
  "cursor": "<string>",
  "creator_country": [
    "US"
  ],
  "audience_country": [
    "US"
  ],
  "creator_language": "en",
  "has_email": true,
  "include": [
    "email"
  ],
  "content_query": "cozy gaming creators"
}
'

import requests

url = "https://api.upriver.ai/v1/creators/search"

payload = {
    "creator_url": "https://www.youtube.com/@MrBeast",
    "name_or_handle": "MrBeast",
    "creator_name": "MrBeast",
    "query": "@mkbhd",
    "limit": 10,
    "platforms": ["youtube", "tiktok"],
    "category_ids": ["technology", "tech_news_lifestyle"],
    "categories": ["gaming and esports", "AI tools"],
    "min_followers": 10000,
    "max_followers": 5000000,
    "follower_bucket": ["10k_50k", "50k_100k"],
    "cursor": "<string>",
    "creator_country": ["US"],
    "audience_country": ["US"],
    "creator_language": "en",
    "has_email": True,
    "include": ["email"],
    "content_query": "cozy gaming creators"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    creator_url: 'https://www.youtube.com/@MrBeast',
    name_or_handle: 'MrBeast',
    creator_name: 'MrBeast',
    query: '@mkbhd',
    limit: 10,
    platforms: ['youtube', 'tiktok'],
    category_ids: ['technology', 'tech_news_lifestyle'],
    categories: ['gaming and esports', 'AI tools'],
    min_followers: 10000,
    max_followers: 5000000,
    follower_bucket: ['10k_50k', '50k_100k'],
    cursor: '<string>',
    creator_country: ['US'],
    audience_country: ['US'],
    creator_language: 'en',
    has_email: true,
    include: ['email'],
    content_query: 'cozy gaming creators'
  })
};

fetch('https://api.upriver.ai/v1/creators/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.upriver.ai/v1/creators/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'creator_url' => 'https://www.youtube.com/@MrBeast',
    'name_or_handle' => 'MrBeast',
    'creator_name' => 'MrBeast',
    'query' => '@mkbhd',
    'limit' => 10,
    'platforms' => [
        'youtube',
        'tiktok'
    ],
    'category_ids' => [
        'technology',
        'tech_news_lifestyle'
    ],
    'categories' => [
        'gaming and esports',
        'AI tools'
    ],
    'min_followers' => 10000,
    'max_followers' => 5000000,
    'follower_bucket' => [
        '10k_50k',
        '50k_100k'
    ],
    'cursor' => '<string>',
    'creator_country' => [
        'US'
    ],
    'audience_country' => [
        'US'
    ],
    'creator_language' => 'en',
    'has_email' => true,
    'include' => [
        'email'
    ],
    'content_query' => 'cozy gaming creators'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.upriver.ai/v1/creators/search"

	payload := strings.NewReader("{\n  \"creator_url\": \"https://www.youtube.com/@MrBeast\",\n  \"name_or_handle\": \"MrBeast\",\n  \"creator_name\": \"MrBeast\",\n  \"query\": \"@mkbhd\",\n  \"limit\": 10,\n  \"platforms\": [\n    \"youtube\",\n    \"tiktok\"\n  ],\n  \"category_ids\": [\n    \"technology\",\n    \"tech_news_lifestyle\"\n  ],\n  \"categories\": [\n    \"gaming and esports\",\n    \"AI tools\"\n  ],\n  \"min_followers\": 10000,\n  \"max_followers\": 5000000,\n  \"follower_bucket\": [\n    \"10k_50k\",\n    \"50k_100k\"\n  ],\n  \"cursor\": \"<string>\",\n  \"creator_country\": [\n    \"US\"\n  ],\n  \"audience_country\": [\n    \"US\"\n  ],\n  \"creator_language\": \"en\",\n  \"has_email\": true,\n  \"include\": [\n    \"email\"\n  ],\n  \"content_query\": \"cozy gaming creators\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.upriver.ai/v1/creators/search")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"creator_url\": \"https://www.youtube.com/@MrBeast\",\n  \"name_or_handle\": \"MrBeast\",\n  \"creator_name\": \"MrBeast\",\n  \"query\": \"@mkbhd\",\n  \"limit\": 10,\n  \"platforms\": [\n    \"youtube\",\n    \"tiktok\"\n  ],\n  \"category_ids\": [\n    \"technology\",\n    \"tech_news_lifestyle\"\n  ],\n  \"categories\": [\n    \"gaming and esports\",\n    \"AI tools\"\n  ],\n  \"min_followers\": 10000,\n  \"max_followers\": 5000000,\n  \"follower_bucket\": [\n    \"10k_50k\",\n    \"50k_100k\"\n  ],\n  \"cursor\": \"<string>\",\n  \"creator_country\": [\n    \"US\"\n  ],\n  \"audience_country\": [\n    \"US\"\n  ],\n  \"creator_language\": \"en\",\n  \"has_email\": true,\n  \"include\": [\n    \"email\"\n  ],\n  \"content_query\": \"cozy gaming creators\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.upriver.ai/v1/creators/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"creator_url\": \"https://www.youtube.com/@MrBeast\",\n  \"name_or_handle\": \"MrBeast\",\n  \"creator_name\": \"MrBeast\",\n  \"query\": \"@mkbhd\",\n  \"limit\": 10,\n  \"platforms\": [\n    \"youtube\",\n    \"tiktok\"\n  ],\n  \"category_ids\": [\n    \"technology\",\n    \"tech_news_lifestyle\"\n  ],\n  \"categories\": [\n    \"gaming and esports\",\n    \"AI tools\"\n  ],\n  \"min_followers\": 10000,\n  \"max_followers\": 5000000,\n  \"follower_bucket\": [\n    \"10k_50k\",\n    \"50k_100k\"\n  ],\n  \"cursor\": \"<string>\",\n  \"creator_country\": [\n    \"US\"\n  ],\n  \"audience_country\": [\n    \"US\"\n  ],\n  \"creator_language\": \"en\",\n  \"has_email\": true,\n  \"include\": [\n    \"email\"\n  ],\n  \"content_query\": \"cozy gaming creators\"\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "score": 0.5,
      "similarity_score": 0.5,
      "similarity_signals": [
        "<string>"
      ],
      "bio": {
        "skip_reason": {
          "code": "<string>",
          "minimum_subscribers": 123,
          "platform": "<string>"
        },
        "summary": "MrBeast is a YouTube creator known for expensive stunts and philanthropy."
      },
      "channels": [
        {
          "platform": "<string>",
          "handle": "<string>",
          "url": "<string>",
          "platform_id": "UCBcRF18a7Qf58cCRy5xuWwQ",
          "display_name": "MrBeast",
          "channel_relationship": "attached",
          "profile_pic_url": "https://d111111abcdef8.cloudfront.net/creator-avatars/v1/...",
          "subscriber_count": 4227,
          "subscriber_count_text": "4.2K",
          "follower_bucket": {
            "id": "<string>",
            "display": "<string>",
            "min_followers": 1,
            "max_followers": 49999
          },
          "engagement_metrics": {
            "avg_views": 125000,
            "avg_likes": 5000,
            "avg_comments": 500,
            "avg_engagement_rate": 0.05
          },
          "video_metrics": {
            "avg_duration_seconds": 615,
            "lookback_weeks": 12,
            "pct_over_8m": 66.7,
            "uploads_per_week": 1.75,
            "weeks_observed": 12,
            "window_complete": true
          },
          "relative_metrics": {
            "engagement": {
              "benchmark_basis": {
                "platform": "<string>",
                "follower_bucket_id": "<string>",
                "benchmark_date": "<string>",
                "content_category": {
                  "id": "<string>",
                  "name": "<string>"
                }
              },
              "avg_views": {},
              "avg_engagement_rate": {}
            }
          }
        }
      ],
      "associated_creators": [
        {
          "creator_id": "<string>"
        }
      ],
      "labels": [
        {
          "id": "<string>",
          "name": "<string>",
          "level": 1,
          "parent_id": "beauty"
        }
      ],
      "creator_id": "<string>",
      "emails": [
        "press@creator.com"
      ],
      "skipped_enrichments": {
        "fields": [],
        "reason": {
          "code": "<string>",
          "minimum_subscribers": 123,
          "platform": "<string>"
        }
      },
      "tags": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "audience": {
        "skip_reason": {
          "code": "<string>",
          "minimum_subscribers": 123,
          "platform": "<string>"
        },
        "description": "Young female audience interested in comedy and lifestyle content.",
        "gender": {
          "value": "female",
          "percentage": 72,
          "confidence": "medium"
        },
        "age": {
          "min_age": 13,
          "max_age": 24,
          "segments": [
            {
              "percentage": 50,
              "min_age": 13,
              "max_age": 17
            }
          ],
          "confidence": "medium"
        },
        "geography": {
          "countries": [
            {
              "country": "<string>",
              "country_name": "United States",
              "percentage": 65
            }
          ],
          "international": true,
          "confidence": "medium"
        },
        "languages": {
          "value": "<string>",
          "breakdown": [
            {
              "language": "<string>",
              "percentage": 50
            }
          ],
          "confidence": "medium"
        }
      }
    }
  ],
  "next_cursor": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Query Parameters

include

string[]

Optional expansions to include in the response.

The same include options are available on GET /v1/creators (lookup by URL) and GET /v1/creators/{creator_id} (lookup by Upriver creator ID).

Include values and what each adds:

engagement_metrics: Recent per-channel engagement performance (average views, likes, comments, engagement rate). Returned as channels[].engagement_metrics.
video_metrics: Per-channel upload cadence and duration-based inventory signals over a trailing 12-week window (YouTube). Returned as channels[].video_metrics.
relative_metrics: Per-channel public benchmark summaries compared with similar creators. Returned as channels[].relative_metrics.
bio: Creator summary and key context. Returned as top-level bio.
audience: Directional audience demographics (age, gender, geography). Returned as top-level audience.
brand_safety: Brand safety advisories with citations. Returned as top-level brand_safety.
email: Public contact email addresses the creator has published for business inquiries, gathered across their linked channels. Returned as top-level emails.
creator_id: Backward-compatible no-op; creator_id is always returned.

Format:

Repeat params: ?include=engagement_metrics&include=bio
CSV: ?include=engagement_metrics,bio

/creators/search modes: include=email is available in every mode (broad query, filter-only browse, and exact creator_url), and may also be passed in the request body. The richer expansions (engagement_metrics, video_metrics, relative_metrics, bio, audience, brand_safety) are returned only for exact creator_url lookups; in broad/filter-only mode they are rejected — call /creators or /creators/{creator_id} to enrich a selected result.

Body

application/json

Input payload for creator discovery.

creator_url

string | null

Known social media URL for the creator.

Example:

"https://www.youtube.com/@MrBeast"

name_or_handle

string | null

Resolve a specific creator by handle or display name. Matches exactly, by prefix, and by fuzzy substring (e.g. 'beast' finds 'MrBeast'). For discovery, use the category/follower/platform filters instead.

Example:

"MrBeast"

creator_name

string | null

deprecated

Deprecated. Use name_or_handle.

Example:

"MrBeast"

query

string | null

deprecated

Deprecated. Use name_or_handle for creator resolution.

Example:

"@mkbhd"

limit

integer

default:10

Maximum number of creators to return, from 1 to 50.

Required range: 1 <= x <= 50

platforms

string[] | null

Optional platform filter. Supported platforms: instagram, podcast, spotify, substack, tiktok, twitch, x, youtube (the alias twitter is accepted for x). Any other value returns a 400 error.

Example:

["youtube", "tiktok"]

category_ids

string[] | null

Optional category filter using taxonomy IDs (e.g. technology, tech_news_lifestyle).

Example:

["technology", "tech_news_lifestyle"]

Response

JSON object containing associated social profiles

Envelope returned by the creator search endpoint.

results

CreatorSearchResult · object[]

Ordered list of creator matches. The first result is the best canonical match when an exact creator exists.

Show child attributes

next_cursor

string | null

Opaque cursor for fetching the next page of results. Null when the current ranked result frontier is exhausted.

⌘I

curl --request POST \
  --url https://api.upriver.ai/v1/creators/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "creator_url": "https://www.youtube.com/@MrBeast",
  "name_or_handle": "MrBeast",
  "creator_name": "MrBeast",
  "query": "@mkbhd",
  "limit": 10,
  "platforms": [
    "youtube",
    "tiktok"
  ],
  "category_ids": [
    "technology",
    "tech_news_lifestyle"
  ],
  "categories": [
    "gaming and esports",
    "AI tools"
  ],
  "min_followers": 10000,
  "max_followers": 5000000,
  "follower_bucket": [
    "10k_50k",
    "50k_100k"
  ],
  "cursor": "<string>",
  "creator_country": [
    "US"
  ],
  "audience_country": [
    "US"
  ],
  "creator_language": "en",
  "has_email": true,
  "include": [
    "email"
  ],
  "content_query": "cozy gaming creators"
}
'

import requests

url = "https://api.upriver.ai/v1/creators/search"

payload = {
    "creator_url": "https://www.youtube.com/@MrBeast",
    "name_or_handle": "MrBeast",
    "creator_name": "MrBeast",
    "query": "@mkbhd",
    "limit": 10,
    "platforms": ["youtube", "tiktok"],
    "category_ids": ["technology", "tech_news_lifestyle"],
    "categories": ["gaming and esports", "AI tools"],
    "min_followers": 10000,
    "max_followers": 5000000,
    "follower_bucket": ["10k_50k", "50k_100k"],
    "cursor": "<string>",
    "creator_country": ["US"],
    "audience_country": ["US"],
    "creator_language": "en",
    "has_email": True,
    "include": ["email"],
    "content_query": "cozy gaming creators"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    creator_url: 'https://www.youtube.com/@MrBeast',
    name_or_handle: 'MrBeast',
    creator_name: 'MrBeast',
    query: '@mkbhd',
    limit: 10,
    platforms: ['youtube', 'tiktok'],
    category_ids: ['technology', 'tech_news_lifestyle'],
    categories: ['gaming and esports', 'AI tools'],
    min_followers: 10000,
    max_followers: 5000000,
    follower_bucket: ['10k_50k', '50k_100k'],
    cursor: '<string>',
    creator_country: ['US'],
    audience_country: ['US'],
    creator_language: 'en',
    has_email: true,
    include: ['email'],
    content_query: 'cozy gaming creators'
  })
};

fetch('https://api.upriver.ai/v1/creators/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.upriver.ai/v1/creators/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'creator_url' => 'https://www.youtube.com/@MrBeast',
    'name_or_handle' => 'MrBeast',
    'creator_name' => 'MrBeast',
    'query' => '@mkbhd',
    'limit' => 10,
    'platforms' => [
        'youtube',
        'tiktok'
    ],
    'category_ids' => [
        'technology',
        'tech_news_lifestyle'
    ],
    'categories' => [
        'gaming and esports',
        'AI tools'
    ],
    'min_followers' => 10000,
    'max_followers' => 5000000,
    'follower_bucket' => [
        '10k_50k',
        '50k_100k'
    ],
    'cursor' => '<string>',
    'creator_country' => [
        'US'
    ],
    'audience_country' => [
        'US'
    ],
    'creator_language' => 'en',
    'has_email' => true,
    'include' => [
        'email'
    ],
    'content_query' => 'cozy gaming creators'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.upriver.ai/v1/creators/search"

	payload := strings.NewReader("{\n  \"creator_url\": \"https://www.youtube.com/@MrBeast\",\n  \"name_or_handle\": \"MrBeast\",\n  \"creator_name\": \"MrBeast\",\n  \"query\": \"@mkbhd\",\n  \"limit\": 10,\n  \"platforms\": [\n    \"youtube\",\n    \"tiktok\"\n  ],\n  \"category_ids\": [\n    \"technology\",\n    \"tech_news_lifestyle\"\n  ],\n  \"categories\": [\n    \"gaming and esports\",\n    \"AI tools\"\n  ],\n  \"min_followers\": 10000,\n  \"max_followers\": 5000000,\n  \"follower_bucket\": [\n    \"10k_50k\",\n    \"50k_100k\"\n  ],\n  \"cursor\": \"<string>\",\n  \"creator_country\": [\n    \"US\"\n  ],\n  \"audience_country\": [\n    \"US\"\n  ],\n  \"creator_language\": \"en\",\n  \"has_email\": true,\n  \"include\": [\n    \"email\"\n  ],\n  \"content_query\": \"cozy gaming creators\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.upriver.ai/v1/creators/search")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"creator_url\": \"https://www.youtube.com/@MrBeast\",\n  \"name_or_handle\": \"MrBeast\",\n  \"creator_name\": \"MrBeast\",\n  \"query\": \"@mkbhd\",\n  \"limit\": 10,\n  \"platforms\": [\n    \"youtube\",\n    \"tiktok\"\n  ],\n  \"category_ids\": [\n    \"technology\",\n    \"tech_news_lifestyle\"\n  ],\n  \"categories\": [\n    \"gaming and esports\",\n    \"AI tools\"\n  ],\n  \"min_followers\": 10000,\n  \"max_followers\": 5000000,\n  \"follower_bucket\": [\n    \"10k_50k\",\n    \"50k_100k\"\n  ],\n  \"cursor\": \"<string>\",\n  \"creator_country\": [\n    \"US\"\n  ],\n  \"audience_country\": [\n    \"US\"\n  ],\n  \"creator_language\": \"en\",\n  \"has_email\": true,\n  \"include\": [\n    \"email\"\n  ],\n  \"content_query\": \"cozy gaming creators\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.upriver.ai/v1/creators/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"creator_url\": \"https://www.youtube.com/@MrBeast\",\n  \"name_or_handle\": \"MrBeast\",\n  \"creator_name\": \"MrBeast\",\n  \"query\": \"@mkbhd\",\n  \"limit\": 10,\n  \"platforms\": [\n    \"youtube\",\n    \"tiktok\"\n  ],\n  \"category_ids\": [\n    \"technology\",\n    \"tech_news_lifestyle\"\n  ],\n  \"categories\": [\n    \"gaming and esports\",\n    \"AI tools\"\n  ],\n  \"min_followers\": 10000,\n  \"max_followers\": 5000000,\n  \"follower_bucket\": [\n    \"10k_50k\",\n    \"50k_100k\"\n  ],\n  \"cursor\": \"<string>\",\n  \"creator_country\": [\n    \"US\"\n  ],\n  \"audience_country\": [\n    \"US\"\n  ],\n  \"creator_language\": \"en\",\n  \"has_email\": true,\n  \"include\": [\n    \"email\"\n  ],\n  \"content_query\": \"cozy gaming creators\"\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "score": 0.5,
      "similarity_score": 0.5,
      "similarity_signals": [
        "<string>"
      ],
      "bio": {
        "skip_reason": {
          "code": "<string>",
          "minimum_subscribers": 123,
          "platform": "<string>"
        },
        "summary": "MrBeast is a YouTube creator known for expensive stunts and philanthropy."
      },
      "channels": [
        {
          "platform": "<string>",
          "handle": "<string>",
          "url": "<string>",
          "platform_id": "UCBcRF18a7Qf58cCRy5xuWwQ",
          "display_name": "MrBeast",
          "channel_relationship": "attached",
          "profile_pic_url": "https://d111111abcdef8.cloudfront.net/creator-avatars/v1/...",
          "subscriber_count": 4227,
          "subscriber_count_text": "4.2K",
          "follower_bucket": {
            "id": "<string>",
            "display": "<string>",
            "min_followers": 1,
            "max_followers": 49999
          },
          "engagement_metrics": {
            "avg_views": 125000,
            "avg_likes": 5000,
            "avg_comments": 500,
            "avg_engagement_rate": 0.05
          },
          "video_metrics": {
            "avg_duration_seconds": 615,
            "lookback_weeks": 12,
            "pct_over_8m": 66.7,
            "uploads_per_week": 1.75,
            "weeks_observed": 12,
            "window_complete": true
          },
          "relative_metrics": {
            "engagement": {
              "benchmark_basis": {
                "platform": "<string>",
                "follower_bucket_id": "<string>",
                "benchmark_date": "<string>",
                "content_category": {
                  "id": "<string>",
                  "name": "<string>"
                }
              },
              "avg_views": {},
              "avg_engagement_rate": {}
            }
          }
        }
      ],
      "associated_creators": [
        {
          "creator_id": "<string>"
        }
      ],
      "labels": [
        {
          "id": "<string>",
          "name": "<string>",
          "level": 1,
          "parent_id": "beauty"
        }
      ],
      "creator_id": "<string>",
      "emails": [
        "press@creator.com"
      ],
      "skipped_enrichments": {
        "fields": [],
        "reason": {
          "code": "<string>",
          "minimum_subscribers": 123,
          "platform": "<string>"
        }
      },
      "tags": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "audience": {
        "skip_reason": {
          "code": "<string>",
          "minimum_subscribers": 123,
          "platform": "<string>"
        },
        "description": "Young female audience interested in comedy and lifestyle content.",
        "gender": {
          "value": "female",
          "percentage": 72,
          "confidence": "medium"
        },
        "age": {
          "min_age": 13,
          "max_age": 24,
          "segments": [
            {
              "percentage": 50,
              "min_age": 13,
              "max_age": 17
            }
          ],
          "confidence": "medium"
        },
        "geography": {
          "countries": [
            {
              "country": "<string>",
              "country_name": "United States",
              "percentage": 65
            }
          ],
          "international": true,
          "confidence": "medium"
        },
        "languages": {
          "value": "<string>",
          "breakdown": [
            {
              "language": "<string>",
              "percentage": 50
            }
          ],
          "confidence": "medium"
        }
      }
    }
  ],
  "next_cursor": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Guides

Agents + LLMs

Updates

Search

Authorizations

Query Parameters

Body

Response