Endpoint Playground

Try the Facet the YouTube creators dataset API

Returns value counts for the YouTube creators dataset by the required `facet`: `region` or `discovery_source`. The counts honour the search filters, such as subscriber, video and view ranges and join or refresh dates, and cover the top 50 values. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

14 Oct 2026: 50 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/youtube-creators/facets?facet=region
Fields with a value in every checked item: value, count

Sample value profiles: count: 4,779 to 477,652, median 12,098.

Request: GET /datasets/youtube-creators/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.43 s
Monitored request: GET /datasets/youtube-creators/facets?facet=region

Facet the YouTube creators dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/youtube-creators/facets?facet=region&sort=relevance" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	region	Facet enum: region, discovery_source
q	string	No		Full-text query over channel_name and bio, max 256 characters
channel_id	string	No		Exact channel id filter, max 128 characters
region	string	No		Exact channel region/country filter (case-insensitive), max 128 characters
discovery_source	string	No		Exact filter for how the channel was discovered, max 128 characters
has_bio	boolean	No		Filter by a non-empty About bio
has_links	boolean	No		Filter by at least one linked external URL
followers_count_available	boolean	No		Filter by whether the channel exposes a public subscriber count
videos_count_available	boolean	No		Filter by whether the channel has a known uploaded-video count
views_count_available	boolean	No		Filter by whether the channel has a known total view count
min_followers	integer	No		Minimum subscriber count
max_followers	integer	No		Maximum subscriber count
min_videos	integer	No		Minimum uploaded-video count
max_videos	integer	No		Maximum uploaded-video count
min_views	integer	No		Minimum total view count
max_views	integer	No		Maximum total view count
joined_after	string	No		Channels created on or after this date (RFC3339 or YYYY-MM-DD)
joined_before	string	No		Channels created on or before this date (RFC3339 or YYYY-MM-DD)
hydrated_after	string	No		Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD)
hydrated_before	string	No		Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD)
sort	string	No	relevance	Sort enum: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "youtube-creators",
    "facet": "region",
    "items": [
      {
        "value": "US",
        "count": 612000
      },
      {
        "value": "IN",
        "count": 388000
      },
      {
        "value": "BR",
        "count": 201000
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Facet Apple Podcasts shows dataset Get an Apple Podcasts show from dataset Search Apple Podcasts shows dataset Search the app-charts dataset Search the app-reviews dataset Search the apps-intelligence dataset Facet the BBB businesses dataset All 136 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.youtubeCreatorsFacetResponseDocDatasets

GET /datasets/youtube-creators/facets

Facet the YouTube creators dataset

Response behavior

- `facet` parameter must be one of the documented enum values; invalid values return `400`. - Aggregates document counts up to top `50` buckets.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: region, discovery_source · allowed: region, discovery_source

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "youtube-creators",
    "facet": "region",
    "items": [
      {
        "value": "US",
        "count": 612000
      },
      {
        "value": "IN",
        "count": 388000
      },
      {
        "value": "BR",
        "count": 201000
      }
    ]
  }
}

Endpoint Playground

Try the Facet the YouTube creators dataset API

What a live request returned

14 Oct 2026: 50 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/youtube-creators/facets?facet=region
Fields with a value in every checked item: value, count

Sample value profiles: count: 4,779 to 477,652, median 12,098.

Request: GET /datasets/youtube-creators/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.43 s
Monitored request: GET /datasets/youtube-creators/facets?facet=region

Facet the YouTube creators dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/youtube-creators/facets?facet=region&sort=relevance" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	region	Facet enum: region, discovery_source
q	string	No		Full-text query over channel_name and bio, max 256 characters
channel_id	string	No		Exact channel id filter, max 128 characters
region	string	No		Exact channel region/country filter (case-insensitive), max 128 characters
discovery_source	string	No		Exact filter for how the channel was discovered, max 128 characters
has_bio	boolean	No		Filter by a non-empty About bio
has_links	boolean	No		Filter by at least one linked external URL
followers_count_available	boolean	No		Filter by whether the channel exposes a public subscriber count
videos_count_available	boolean	No		Filter by whether the channel has a known uploaded-video count
views_count_available	boolean	No		Filter by whether the channel has a known total view count
min_followers	integer	No		Minimum subscriber count
max_followers	integer	No		Maximum subscriber count
min_videos	integer	No		Minimum uploaded-video count
max_videos	integer	No		Maximum uploaded-video count
min_views	integer	No		Minimum total view count
max_views	integer	No		Maximum total view count
joined_after	string	No		Channels created on or after this date (RFC3339 or YYYY-MM-DD)
joined_before	string	No		Channels created on or before this date (RFC3339 or YYYY-MM-DD)
hydrated_after	string	No		Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD)
hydrated_before	string	No		Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD)
sort	string	No	relevance	Sort enum: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "youtube-creators",
    "facet": "region",
    "items": [
      {
        "value": "US",
        "count": 612000
      },
      {
        "value": "IN",
        "count": 388000
      },
      {
        "value": "BR",
        "count": 201000
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.youtubeCreatorsFacetResponseDocDatasets

GET /datasets/youtube-creators/facets

Facet the YouTube creators dataset

Response behavior

- `facet` parameter must be one of the documented enum values; invalid values return `400`. - Aggregates document counts up to top `50` buckets.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: region, discovery_source · allowed: region, discovery_source

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "youtube-creators",
    "facet": "region",
    "items": [
      {
        "value": "US",
        "count": 612000
      },
      {
        "value": "IN",
        "count": 388000
      },
      {
        "value": "BR",
        "count": 201000
      }
    ]
  }
}