API दस्तावेज़

मेटाडेटा (title, channel, thumbnail) के साथ किसी YouTube वीडियो का ट्रांसक्रिप्ट पाएं। साथ ही language_code बनाम requested_language, caption_type (manual या auto, अज्ञात होने पर null) और cached / fetched_at भी लौटाता है।

अनुरोध

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

प्रतिक्रिया

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "requested_language": "en",
    "caption_type": "manual",
    "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,
    "cached": true,
    "fetched_at": "2026-09-20T03:10:58.938Z"
  }
}

किसी वीडियो में उपलब्ध कैप्शन भाषाओं की सूची (manual और auto-generated), ट्रांसक्रिप्ट लाने से पहले। default_language_code वह है जो /transcript बिना भाषा के लौटाता है; जिस वीडियो में कैप्शन बंद हैं, उसके लिए खाली सूची मिलती है।

अनुरोध

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

प्रतिक्रिया

{
  "success": true,
  "data": {
    "video_id": "kJQP7kiw5Fk",
    "default_language_code": "en",
    "languages": [
      { "language_code": "en", "name": "English - en", "caption_type": "manual" },
      { "language_code": "es", "name": "Spanish", "caption_type": "manual" }
    ]
  }
}

एक ही कॉल में 100 तक वीडियो कतार में डालें। तुरंत एक batch_id लौटाता है और ट्रांसक्रिप्ट बैकग्राउंड में लाता है। GET /batch से स्थिति देखें, या webhook_url दें ताकि पूरा होने पर एक साइन किया हुआ POST (X-GYT-Signature हेडर) मिले। फेल्ड वीडियो के लिए कभी चार्ज नहीं किया जाता।

अनुरोध

curl -X POST "https://getyoutubetranscript.com/api/v1/batch" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
        "videos": ["jNQXAC9IVRw", "https://youtu.be/dQw4w9WgXcQ"],
        "webhook_url": "https://example.com/hooks/transcripts"
      }'

प्रतिक्रिया

{
  "success": true,
  "data": {
    "batch_id": "324eb615-e4d5-4b3c-b8e7-04235671066b",
    "status": "queued",
    "total": 2,
    "succeeded": 0,
    "failed": 0,
    "pending": 2,
    "results_url": "https://getyoutubetranscript.com/api/v1/batch?id=324eb615-...",
    "webhook_secret": "whsec_..."
  }
}

बैच की स्थिति, गिनती और भेजे गए क्रम में परिणामों का एक पेज। सफल आइटम में /transcript जैसे ही फ़ील्ड होते हैं; फेल्ड आइटम में error_code होता है।

अनुरोध

curl "https://getyoutubetranscript.com/api/v1/batch?id=324eb615-e4d5-4b3c-b8e7-04235671066b" \
  -H "Authorization: Bearer sk_live_..."

प्रतिक्रिया

{
  "success": true,
  "data": {
    "batch_id": "324eb615-...",
    "status": "completed",
    "total": 2,
    "succeeded": 1,
    "failed": 1,
    "credits_charged": 1,
    "items": [
      { "position": 0, "status": "succeeded", "charged": true, "video_id": "jNQXAC9IVRw", "caption_type": "manual", "transcript": "All right, so here we are...", ... },
      { "position": 1, "status": "failed", "charged": false, "video_id": "dQw4w9WgXcQ", "error_code": "TRANSCRIPT_DISABLED" }
    ],
    "next_offset": null
  }
}

फिल्टर और पेजिनेशन के साथ YouTube वीडियो सर्च करें।

अनुरोध

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

प्रतिक्रिया

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

किसी चैनल हैंडल, URL, या यूजरनेम को उसकी असली चैनल ID में रिज़ॉल्व करें। एक सिंटैक्टिक इनपुट (पहले से चैनल ID या उसे युक्त URL) बिना किसी नेटवर्क कॉल के तुरंत रिज़ॉल्व होता है; एक सादा हैंडल एक असली लुकअप ट्रिगर करता है।

अनुरोध

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

प्रतिक्रिया

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

चैनल की जानकारी (टाइटल, सब्सक्राइबर, विवरण, अवतार) और चैनल के होम टैब पर दिखने वाले नए वीडियो। पूरी अपलोड हिस्ट्री के लिए /channel/videos का उपयोग करें।

अनुरोध

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

प्रतिक्रिया

{
  "success": true,
  "data": {
    "channel": { "id": "UCBJycsmduvYEL83R_U4JriQ", "title": "Marques Brownlee", "subscribers": 1160000, "avatar": "https://..." },
    "about": { "description": "...", "links": [] },
    "videos_sections": [ ... ]
  }
}

किसी चैनल के सभी अपलोड किए गए वीडियो, सबसे नए पहले, पेज के हिसाब से।

अनुरोध

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

प्रतिक्रिया

{
  "success": true,
  "data": {
    "videos": [ { "position": 1, "id": "...", "title": "...", "views": "6.2M", "published_time": "1d ago", "length": "10:47" } ],
    "has_more": true,
    "continuation_token": "c_pqHR9v13sqaqxlcKhA4MnA"
  }
}

किसी एक चैनल के वीडियो में खोजें, पेज के हिसाब से।

अनुरोध

curl "https://getyoutubetranscript.com/api/v1/channel/search?channel=@mkbhd&q=iphone" \
  -H "Authorization: Bearer sk_live_..."

प्रतिक्रिया

{
  "success": true,
  "data": {
    "videos": [ { "position": 1, "id": "...", "title": "...", "published_time": "3w ago", "length": "17:14", "channel": { "name": "Marques Brownlee" } } ],
    "has_more": true,
    "continuation_token": "c_pnm10M6orzLgOTVWJk2oww"
  }
}

किसी प्लेलिस्ट के सभी वीडियो, पेज के हिसाब से। आखिरी पेज पर continuation_token null होता है।

अनुरोध

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

प्रतिक्रिया

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

इस्तेमाल करने से पहले इस की का बचा हुआ क्रेडिट बैलेंस देखें - यह वही डेटा है जो MCP का get_credits टूल देता है।

अनुरोध

curl "https://getyoutubetranscript.com/api/v1/credits" \
  -H "Authorization: Bearer sk_live_..."

प्रतिक्रिया

{
  "success": true,
  "data": {
    "plan_credits_left": 87,
    "topup_credits_left": 0,
    "plan": "monthly",
    "rate_limit_per_minute": 200
  }
}