Tài liệu API

Lấy transcript của một video YouTube, kèm metadata (tiêu đề, kênh, thumbnail).

Yêu cầu

curl "https://getyoutubetranscript.com/api/v1/transcript?v=jNQXAC9IVRw" \
  -H "Authorization: Bearer sk_live_..."

Phản hồi

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "title": "Me at the zoo",
    "author_name": "jawed",
    "author_url": "https://www.youtube.com/channel/UC4Qob...",
    "thumbnail_url": "https://...",
    "transcript": "All right, so here we are...",
    "word_count": 39
  }
}

Tìm kiếm video YouTube với bộ lọc và phân trang.

Yêu cầu

curl "https://getyoutubetranscript.com/api/v1/search?q=lofi+beats" \
  -H "Authorization: Bearer sk_live_..."

Phản hồi

{
  "success": true,
  "data": {
    "query": "lofi beats",
    "video_results": [ { "title": "...", "videoId": "...", "channel": { "name": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}

Phân giải handle, URL hoặc username của một kênh thành channel ID thực. Đầu vào có cấu trúc sẵn (đã là channel ID hoặc URL chứa sẵn ID) được phân giải ngay lập tức, không cần gọi mạng; một handle trần sẽ kích hoạt một lượt tra cứu thực.

Yêu cầu

curl "https://getyoutubetranscript.com/api/v1/resolve?handle=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Phản hồi

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "handle": "http://www.youtube.com/@mkbhd",
    "resolved_via": "scrape"
  }
}

Lấy các video trong một playlist. Hiện chỉ trả về trang đầu tiên - has_more cho biết còn video khác không, nhưng lấy thêm trang tiếp theo chưa được hỗ trợ.

Yêu cầu

curl "https://getyoutubetranscript.com/api/v1/playlist?list=PLxxx" \
  -H "Authorization: Bearer sk_live_..."

Phản hồi

{
  "success": true,
  "data": {
    "playlist_id": "PLxxx",
    "title": "...",
    "videos": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." } } ],
    "has_more": true
  }
}