YouTube API
YouTube video metadata, channel info, search, comments, and transcriptions.
- Channel IDs and @handles are both supported for the channels endpoint
- Transcription supports multiple languages via the
languageparameter - Both manual and auto-generated captions are returned
- Pagination uses
nextPageToken(continuation token) for comments
Videos
GET /youtube/videos/:videoId — 4 credits
Get YouTube video details by ID.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
videoId | string | Yes | — | YouTube video ID |
cURL
curl -H "x-api-key: sk_byc_xxx" \
https://api.bycrawl.com/youtube/videos/dQw4w9WgXcQResponse
{
"id": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
"description": "The official video for \"Never Gonna Give You Up\" by Rick Astley...",
"channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
"channelTitle": "Rick Astley",
"viewCount": 1748801094,
"likeCount": 18832650,
"commentCount": 2400000,
"duration": "3:33",
"publishedAt": "2009-10-25",
"thumbnail": "https://...",
"keywords": ["rick astley", "Never Gonna Give You Up", "nggyu", "rick rolled"]
}GET /youtube/videos/:videoId/comments — 3 credits
Get YouTube video comments.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
videoId | string | Yes | — | YouTube video ID |
count | integer | No | 20 | Number of comments (max 50) |
cURL
curl -H "x-api-key: sk_byc_xxx" \
"https://api.bycrawl.com/youtube/videos/dQw4w9WgXcQ/comments?count=10"Response
{
"comments": [
{
"id": "Ugzge340dBgB75hWBm54AaABAg",
"text": "can confirm: he never gave us up",
"author": "@YouTube",
"authorChannelId": "UCBR8-60-B28hp2BmDPdntcQ",
"authorAvatar": "https://...",
"isVerified": false,
"likeCount": 193000,
"replyCount": 0,
"publishedAt": "10 months ago"
}
// ... more comments
],
"nextPageToken": null
}GET /youtube/videos/:videoId/transcription — 4 credits
Get video transcription (subtitles). Returns timestamped segments and full text. Supports both manual and auto-generated captions.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
videoId | string | Yes | — | YouTube video ID |
language | string | No | en | Language code (e.g., en, zh-Hant, ja) |
cURL
curl -H "x-api-key: sk_byc_xxx" \
"https://api.bycrawl.com/youtube/videos/dQw4w9WgXcQ/transcription?language=en"Response
{
"videoId": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
"language": "en",
"isAutoGenerated": false,
"availableLanguages": {
"manual": ["de-DE", "en", "es-419", "ja", "pt-BR"],
"automatic": ["af", "ar", "zh-Hans", "zh-Hant", "fr", "de", "ja", "ko", "es"]
},
"segments": [
{ "start": 18.64, "duration": 3.24, "text": "We're no strangers to love" },
{ "start": 22.64, "duration": 4.32, "text": "You know the rules and so do I" }
// ... more segments
],
"fullText": "We're no strangers to love You know the rules and so do I..."
}Channels
GET /youtube/channels/:channelId — 2 credits
Get YouTube channel info by channel ID or @handle.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
channelId | string | Yes | — | Channel ID or @handle (e.g. @MrBeast) |
cURL
curl -H "x-api-key: sk_byc_xxx" \
https://api.bycrawl.com/youtube/channels/@MrBeastResponse
{
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"title": "MrBeast",
"description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every...",
"subscriberCount": 470000000,
"videoCount": 0,
"viewCount": 0,
"thumbnail": "https://...",
"banner": "https://...",
"createdAt": null,
"country": ""
}Search
GET /youtube/videos/search — 2 credits
Search YouTube videos by keyword.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | — | Search query |
count | integer | No | 10 | Number of results (max 20) |
cURL
curl -H "x-api-key: sk_byc_xxx" \
"https://api.bycrawl.com/youtube/videos/search?q=cooking&count=5"Response
{
"videos": [
{
"id": "WP8EMyoWUlM",
"title": "I Cooked For A Lion",
"description": "",
"channelId": "UCMyOj6fhvKFMjxUCp3b_3gA",
"channelTitle": "Nick DiGiovanni",
"viewCount": 43460930,
"likeCount": 0,
"commentCount": 0,
"duration": "24:04",
"publishedAt": "",
"thumbnail": "https://...",
"keywords": []
}
// ... more videos
],
"nextPageToken": null
}