YouTube Transcriber logoYouTube Transcriber
API Reference

Resolve Youtube handle

Free endpoint. Accepts any @handle, URL, or ID and returns the channel id.

Quick example

curl "https://getyoutubetranscriber.com/api/v2/channel/resolve?input=%40TED" \
  -H "Authorization: Bearer ytt_your_key_here"

Full parameter list, response schema, and try-it samples in every language are below.

GET
/api/v2/channel/resolve

Authorization

AuthorizationBearer <token>

Send your API key as Authorization: Bearer <api_key>.

In: header

Query Parameters

inputstring

Channel identifier. Accepts an @handle (e.g. @TED), a channel URL (e.g. https://www.youtube.com/@TED), or a bare UCID (e.g. UCAuUUnT6oDeKwE6v1NGQxug).

Length1 <= length <= 200

Response Body

curl -X GET "http://localhost:3011/api/v2/channel/resolve?input=%40TED"
{
  "channel_id": "string",
  "resolved_from": "string"
}
{
  "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
}

Search videos or channels GET

Search YouTube videos or channels

Search videos in a channel by keyword GET

Keyword-search within a channel. Both `channel` and `q` are required on the first page (pass `continuation` for subsequent pages). To list every upload from a channel without a search keyword, use `/api/v2/channel/videos` instead.