API Reference
Search videos or channels
Search YouTube videos or channels
Quick example
curl "https://getyoutubetranscriber.com/api/v2/search?q=ted%20talk&type=video" \
-H "Authorization: Bearer ytt_your_key_here"Full parameter list, response schema, and try-it samples in every language are below.
AuthorizationBearer <token>
Send your API key as Authorization: Bearer <api_key>.
In: header
Query Parameters
q?string
Search keyword. Matches against video titles, channel names, descriptions, and tags across all of YouTube.
Length
1 <= length <= 200type?string
Search for videos or channels.
Default
"video"Value in
"video" | "channel"continuation?string
Cursor for the next page of results.
Length
1 <= length <= 8192Response Body
curl -X GET "http://localhost:3011/api/v2/search?q=ted+talk&type=video&continuation=string"{
"results": [
{
"type": "video",
"video_id": "string",
"title": "string",
"channel_id": "string",
"channel_title": "string",
"channel_handle": "string",
"channel_verified": true,
"length_text": "string",
"view_count_text": "string",
"published_time_text": "string",
"has_captions": true,
"thumbnails": [
{
"url": "string",
"width": 0,
"height": 0
}
]
}
],
"result_count": 0,
"continuation_token": "string",
"has_more": true
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}{
"type": "https://getyoutubetranscriber.com/api/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "video_url is required",
"instance": "/api/v2/transcript",
"request_id": "req_01J0XYZ...",
"code": "E_VALIDATION",
"errors": [
{
"field": "string",
"code": "string",
"message": "string"
}
],
"retry_after": 0
}