API दस्तावेज़

YouTube ट्रांसक्रिप्ट, सर्च, और मेटाडेटा के लिए एक REST API। अपने dashboard से एक API key लें — 100 फ्री क्रेडिट्स, कार्ड की जरूरत नहीं।

प्रमाणीकरण

अपनी API key को बियरर टोकन के रूप में, या x-api-key के जरिए पास करें:

Authorization: Bearer sk_live_...
# or
x-api-key: sk_live_...

बेस URL

https://getyoutubetranscript.com/api/v1

क्रेडिट्स और प्लान

प्लानकीमतक्रेडिट्स/माहटॉप-अप कीमतरेट लिमिट
Free$0100 (एक बार)60 req/min
मासिक$5.00/माह1,000$2.50 / 1,000200 req/min
वार्षिक$4.50/माह ($54/वर्ष)1,000$1.50 / 1,000300 req/min

1 क्रेडिट = 1 सफल रिक्वेस्ट। फेल्ड रिक्वेस्ट के लिए कभी चार्ज नहीं किया जाता। टॉप-अप क्रेडिट्स खरीद के 30 दिन बाद या आपकी मौजूदा बिलिंग अवधि के अंत में, जो भी बाद में हो, एक्सपायर हो जाते हैं, और इन्हें खर्च करने के लिए एक सक्रिय सब्सक्रिप्शन जरूरी है।

एंडपॉइंट्स

GET/transcript1 क्रेडिट

मेटाडेटा (title, channel, thumbnail) के साथ किसी YouTube वीडियो का ट्रांसक्रिप्ट पाएं।

पैरामीटरआवश्यकविवरण
vहांवीडियो ID या पूरा YouTube URL
languageनहींभाषा कोड (डिफ़ॉल्ट: en)

अनुरोध

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

प्रतिक्रिया

{
  "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
  }
}
GET/search1 क्रेडिट / पेज

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

पैरामीटरआवश्यकविवरण
qहांसर्च क्वेरी (कम से कम 2 अक्षर)
countryनहीं2-अक्षर वाला कंट्री कोड (डिफ़ॉल्ट: us)
languageनहींभाषा कोड (डिफ़ॉल्ट: en)
page_tokenनहींअगला पेज लाने के लिए पिछले रिस्पॉन्स का pagination.next_page_token
limitनहींअधिकतम परिणाम (डिफ़ॉल्ट 20, अधिकतम 50)

अनुरोध

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": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}
GET/resolveFree

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

पैरामीटरआवश्यकविवरण
handleहांचैनल ID, URL, या @handle

अनुरोध

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"
  }
}
GET/playlist1 क्रेडिट / पेज

किसी प्लेलिस्ट के वीडियो पाएं। फिलहाल यह केवल पहला पेज देता है - has_more बताता है कि और वीडियो हैं या नहीं, लेकिन अतिरिक्त पेज लाना अभी सपोर्टेड नहीं है।

पैरामीटरआवश्यकविवरण
listहांप्लेलिस्ट ID या URL

अनुरोध

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
  }
}

त्रुटियाँ

Errors HTTP status के अलावा एक JSON बॉडी लौटाते हैं जिसमें ब्रांच करने के लिए एक स्थिर code फील्ड होता है:

स्थितिकोडअर्थ
400BAD_REQUESTपैरामीटर गायब या अमान्य है
401MISSING_API_KEY / INVALID_API_KEYकोई key नहीं दी गई, या key अमान्य/रद्द है
402PAYMENT_REQUIREDक्रेडिट्स खत्म - टॉप-अप खरीदें या अपग्रेड करें
404VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUNDवीडियो या रिसोर्स नहीं मिला
429RATE_LIMITEDआपके प्लान टियर के लिए बहुत ज्यादा रिक्वेस्ट
503UPSTREAM_UNAVAILABLEअस्थायी अपस्ट्रीम समस्या - फिर से कोशिश करना सुरक्षित है

जल्द आ रहा है

किसी चैनल के अंदर सर्च, चैनल के सभी वीडियो लिस्ट करना, और पूरा प्लेलिस्ट पेजिनेशन विकास में हैं। RSS के जरिए नए अपलोड ट्रैक करना YouTube की ओर से एक असंबंधित समस्या के कारण अस्थायी रूप से अनुपलब्ध है।

इस API को किसी AI टूल के साथ इस्तेमाल करना

खुद रिक्वेस्ट लिखने के बजाय Claude (या किसी अन्य AI कोडिंग टूल) से यह API कॉल करवाना चाहते हैं? YouTube Transcript skill डाउनलोड करें - एक तैयार Claude Skill जो उसे ट्रांसक्रिप्ट लाना, सर्च करना, और बहुत कुछ सिखाती है।