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 | $0 | 100 (एक बार) | — | 60 req/min |
| मासिक | $5.00/माह | 1,000 | $2.50 / 1,000 | 200 req/min |
| वार्षिक | $4.50/माह ($54/वर्ष) | 1,000 | $1.50 / 1,000 | 300 req/min |
1 क्रेडिट = 1 सफल रिक्वेस्ट। फेल्ड रिक्वेस्ट के लिए कभी चार्ज नहीं किया जाता। टॉप-अप क्रेडिट्स खरीद के 30 दिन बाद या आपकी मौजूदा बिलिंग अवधि के अंत में, जो भी बाद में हो, एक्सपायर हो जाते हैं, और इन्हें खर्च करने के लिए एक सक्रिय सब्सक्रिप्शन जरूरी है।
एंडपॉइंट्स
/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
}
}/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": "..." }
}
}/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"
}
}/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 फील्ड होता है:
| स्थिति | कोड | अर्थ |
|---|---|---|
| 400 | BAD_REQUEST | पैरामीटर गायब या अमान्य है |
| 401 | MISSING_API_KEY / INVALID_API_KEY | कोई key नहीं दी गई, या key अमान्य/रद्द है |
| 402 | PAYMENT_REQUIRED | क्रेडिट्स खत्म - टॉप-अप खरीदें या अपग्रेड करें |
| 404 | VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND | वीडियो या रिसोर्स नहीं मिला |
| 429 | RATE_LIMITED | आपके प्लान टियर के लिए बहुत ज्यादा रिक्वेस्ट |
| 503 | UPSTREAM_UNAVAILABLE | अस्थायी अपस्ट्रीम समस्या - फिर से कोशिश करना सुरक्षित है |
जल्द आ रहा है
किसी चैनल के अंदर सर्च, चैनल के सभी वीडियो लिस्ट करना, और पूरा प्लेलिस्ट पेजिनेशन विकास में हैं। RSS के जरिए नए अपलोड ट्रैक करना YouTube की ओर से एक असंबंधित समस्या के कारण अस्थायी रूप से अनुपलब्ध है।
इस API को किसी AI टूल के साथ इस्तेमाल करना
खुद रिक्वेस्ट लिखने के बजाय Claude (या किसी अन्य AI कोडिंग टूल) से यह API कॉल करवाना चाहते हैं? YouTube Transcript skill डाउनलोड करें - एक तैयार Claude Skill जो उसे ट्रांसक्रिप्ट लाना, सर्च करना, और बहुत कुछ सिखाती है।