Datasets API endpoint
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.
/datasets/youtube-creators/facetsReturns terms aggregation counts for the YouTube creators dataset under search filters.
Dataset id enum:
youtube-creatorsQuery parameters:
facet: required facet field enum: region, discovery_source.sort: optional sort enum: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc.q, channel_id, region, discovery_source, has_bio, has_links, followers_count_available, videos_count_available, views_count_available, min_followers, max_followers, min_videos, max_videos, min_views, max_views, joined_after, joined_before, hydrated_after, hydrated_before: same filters as search.Response behavior:
facet parameter must be one of the documented enum values; invalid values return 400.50 buckets.| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| value | 50 | |
| count | 50 | 4,779 to 477,652, median 12,098 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| facet | string | Yes | Facet enum: region, discovery_source Allowed values: region, discovery_source. | region | |
| 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 | Sort enum: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc Allowed values: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/youtube-creators/facets?facet=region&q=coffee&has_bio=true&has_links=true&followers_count_available=true&videos_count_available=true&views_count_available=true&sort=relevance" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "youtube-creators",
"facet": "region",
"items": [
{
"value": "US",
"count": 612000
},
{
"value": "IN",
"count": 388000
},
{
"value": "BR",
"count": 201000
}
]
}
}Request schema
No body schema
Response schema
#/definitions/datasets.youtubeCreatorsFacetResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.YoutubeCreatorFacetResponse | No | ||||
| data.dataset | string | No | ||||
| data.facet | string | No | ||||
| data.items | array | No | ||||
| data.items[].count | integer | No | ||||
| data.items[].value | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/youtube-creators/facets?facet=region&q=coffee&has_bio=true&has_links=true&followers_count_available=true&videos_count_available=true&views_count_available=true&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"