Datasets API endpoint
Returns one YouTube channel from the dataset by `channel_id`. The record has channel name and URL, bio, region, join date, links, profile picture, and subscriber, video and view counts, each with an availability flag. A channel not in the dataset returns 404.
/datasets/youtube-creators/items/{channel_id}Returns one public YouTube channel record by channel id from dataset id enum value youtube-creators.
Path parameters:
channel_id: required YouTube channel id, e.g. UCxxxxxxxxxxxxxxxxxxxxxxxx.Dataset id enum:
youtube-creatorsResponse behavior:
404 when the channel is not present in the dataset.| Field | In the sample | Value in the sample |
|---|---|---|
| channel_id | Has a value | |
| channel_name | Has a value | |
| channel_url | Has a value | youtube.com |
| profile_pic | Has a value | yt3.googleusercontent.com |
| links | Has a value | 4 entries |
| followers_count | Has a value | 518,000,000 |
| videos_count | Has a value | 1,003 |
| views_count | Has a value | 140,603,012,575 |
| followers_count_available | Has a value | true |
| videos_count_available | Has a value | true |
| views_count_available | Has a value | true |
| region | Has a value | |
| bio | Has a value | 997 characters |
| joined_date | Has a value | 2012-02-20 |
| discovery_source | Has a value | |
| status | Has a value | |
| discovered_at | Has a value | 2026-08-05 |
| hydrated_at | Has a value | 2026-09-22 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| channel_id (path) | string | Yes | YouTube channel id, e.g. UCxxxxxxxxxxxxxxxxxxxxxxxx | UCX6OQ3DkcsbYNE6H8uQQuVA | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/youtube-creators/items/UCX6OQ3DkcsbYNE6H8uQQuVA" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channel_name": "MrBeast",
"channel_url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
"profile_pic": "https://yt3.googleusercontent.com/avatar.jpg",
"links": [
"https://www.beastphilanthropy.org"
],
"followers_count": 300000000,
"followers_count_available": true,
"videos_count": 830,
"videos_count_available": true,
"views_count": 55000000000,
"views_count_available": true,
"region": "US",
"bio": "SUBSCRIBE FOR A COOKIE!",
"joined_date": "2012-02-20T00:00:00Z",
"discovery_source": "commoncrawl",
"status": "ok",
"discovered_at": "2026-07-03T00:00:00Z",
"hydrated_at": "2026-08-19T00:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/datasets.youtubeCreatorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | es.YoutubeChannelCandidate | No | ||||
| data.bio | string | No | ||||
| data.channel_id | string | No | ||||
| data.channel_name | string | No | ||||
| data.channel_url | string | No | ||||
| data.discovered_at | string | No | ||||
| data.discovery_source | string | No | ||||
| data.followers_count | integer | No | ||||
| data.followers_count_available | boolean | No | ||||
| data.hydrated_at | string | No | ||||
| data.joined_date | string | No | ||||
| data.links | array | No | ||||
| data.profile_pic | string | No | ||||
| data.region | string | No | ||||
| data.status | string | No | ||||
| data.videos_count | integer | No | ||||
| data.videos_count_available | boolean | No | ||||
| data.views_count | integer | No | ||||
| data.views_count_available | boolean | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/items/UCX6OQ3DkcsbYNE6H8uQQuVA" \
-H "x-api-key: $CRAWLORA_API_KEY"