Migrating from TranscriptAPI.com: A Field Guide

Switching a YouTube transcript integration from TranscriptAPI.com to GetYouTubeTranscript - parameter mapping, a before/after curl example, endpoint equivalents, and the real gaps that do not map 1:1.

00:06:00 · SEP 26, 2026

त्वरित उत्तर

TranscriptAPI.com के video_url, format, और include_timestamp हमारे v और language पैरामीटर से मेल खाते हैं - लेकिन हमारी पब्लिक API उनके format=json विकल्प की तरह प्रति-सेगमेंट टाइमस्टैम्प नहीं देती। अगर आपको सिर्फ प्लेन ट्रांसक्रिप्ट टेक्स्ट और मेटाडेटा चाहिए, तो यह लगभग सीधा बदलाव है; अगर आप API रिस्पॉन्स से सेगमेंट-लेवल टाइमस्टैम्प पर निर्भर हैं, तो स्विच करने से पहले अंतर वाला भाग पढ़ें।

पैरामीटर मैपिंग

दोनों API बियरर टोकन से ऑथेंटिकेट होती हैं और पूरा URL, छोटा URL, या सिर्फ वीडियो ID स्वीकार करती हैं। TranscriptAPI के बाकी ट्रांसक्रिप्ट पैरामीटर हमारे साथ इस तरह मेल खाते हैं:

TranscriptAPI.com	GetYouTubeTranscript	नोट
`Authorization: Bearer KEY`	`Authorization: Bearer KEY`	हम x-api-key को भी वैकल्पिक हेडर के रूप में स्वीकार करते हैं।
`video_url`	`v (या url, videoId)`	वही स्वीकृत फॉर्मैट: पूरा URL, छोटा URL, या 11-अक्षर की ID।
`language`	`language`	हमारा एक सिंगल कोड लेता है डिफ़ॉल्ट के साथ, कॉमा-सेपरेटेड प्राथमिकता सूची नहीं - हर कॉल में एक भाषा माँगें।
`format=json\|text`	`(कोई नहीं - हमेशा प्लेन टेक्स्ट)`	हमारा रिस्पॉन्स हमेशा transcript फ़ील्ड में फ्लैट टेक्स्ट देता है, जो उनके format=text के बराबर है।
`include_timestamp`	`(उपलब्ध नहीं)`	प्रति-सेगमेंट start/duration टाइमस्टैम्प आज हमारे पब्लिक रिस्पॉन्स में नहीं हैं - नीचे अंतर देखें।
`send_metadata=true`	`(हमेशा शामिल)`	title, author_name, author_url, और thumbnail_url हमेशा रिस्पॉन्स में होते हैं - किसी फ्लैग की ज़रूरत नहीं।

पहले / बाद में

TranscriptAPI.com

curl -X GET "https://transcriptapi.com/api/v2/youtube/transcript?video_url=https://youtu.be/dQw4w9WgXcQ&language=en&send_metadata=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

GetYouTubeTranscript

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

# => { "success": true, "data": { "video_id": "...", "language_code": "en",
#      "title": "...", "author_name": "...", "author_url": "...",
#      "thumbnail_url": "...", "transcript": "...", "word_count": 1847 } }

वही वीडियो, दोनों तरफ एक क्रेडिट। हमारी तरफ मेटाडेटा डिफ़ॉल्ट रूप से आता है, तो कोई send_metadata फ्लैग याद रखने की ज़रूरत नहीं।

अन्य एंडपॉइंट्स

TranscriptAPI.com	GetYouTubeTranscript	नोट
`GET /youtube/info (मुफ़्त)`	`GET /resolve?handle=... (मुफ़्त)`	हमारा एक हैंडल/URL को चैनल ID में रिज़ॉल्व करता है; वीडियो-लेवल मेटाडेटा के लिए /transcript कॉल करें और रिस्पॉन्स फ़ील्ड पढ़ें।
`GET /youtube/search (1 क्रेडिट)`	`GET /search?q=... (1 क्रेडिट/पेज)`	वही विचार - पेजिनेटेड सर्च, हर फ़ेच किए पेज पर एक क्रेडिट।
`GET /youtube/channel/resolve (मुफ़्त)`	`GET /resolve?handle=... (मुफ़्त)`	सीधा समकक्ष।
`GET /youtube/channel/videos (1/पेज)`	`GET /channel/videos?channel=... (1 क्रेडिट/पेज)`	वही पेजिनेशन मॉडल - रिस्पॉन्स का कंटिन्यूएशन टोकन वापस भेजें।
`GET /youtube/channel/search (1 क्रेडिट)`	`GET /channel/search?channel=...&q=... (1 क्रेडिट/पेज)`	सीधा समकक्ष।
`GET /youtube/channel/playlists, /channel/posts`	`(कोई समकक्ष नहीं)`	फ़िलहाल उपलब्ध नहीं - नीचे अंतर देखें।

क्या 1:1 मेल नहीं खाता

API रिस्पॉन्स में प्रति-सेगमेंट टाइमस्टैम्प नहीं। TranscriptAPI का format=json + include_timestamp=true, start/duration के साथ सेगमेंट देता है; हमारी पब्लिक API सिर्फ फ्लैट ट्रांसक्रिप्ट स्ट्रिंग देती है। (सेगमेंट-लेवल टाइमस्टैम्प हमारे डेटाबेस में मौजूद हैं और वेबसाइट पर खुद क्लिक करने योग्य ट्रांसक्रिप्ट व्यू को पावर देते हैं - बस अभी पब्लिक API रिस्पॉन्स में नहीं हैं।)
यहाँ language एक सिंगल कोड है, प्राथमिकता सूची नहीं। TranscriptAPI de,en,asr जैसी कॉमा-सेपरेटेड सूची बाएँ से दाएँ आज़माता है; हमारा एक कोड डिफ़ॉल्ट के साथ लेता है। अगर आप फॉलबैक चेन पर निर्भर थे, तो खुद अलग वैल्यू के साथ फिर कोशिश करें।
चैनल प्लेलिस्ट या चैनल पोस्ट्स के लिए कोई एंडपॉइंट नहीं। TranscriptAPI के /channel/playlists और /channel/posts का यहाँ फ़िलहाल कोई समकक्ष नहीं है।

अगर प्लेन ट्रांसक्रिप्ट टेक्स्ट, मेटाडेटा, सर्च, और चैनल डेटा आपके इस्तेमाल के लिए काफ़ी है, तो यह लगभग सीधा बदलाव है - 100 मुफ़्त क्रेडिट (बिना कार्ड) के लिए साइन अप करें और पूरी कीमत और एंडपॉइंट सूची देखें, या पूरे पैरामीटर रेफरेंस के लिए API डॉक्स देखें।

माइग्रेशन FAQ

Q01

क्या मुझे अपना ऑथ हेडर बदलना होगा?

नहीं - दोनों API Authorization: Bearer YOUR_KEY इस्तेमाल करती हैं। हमारी x-api-key को भी विकल्प के रूप में स्वीकार करती है।

Q02

क्या मेरे मौजूदा वीडियो URL और ID काम करते रहेंगे?

हाँ - दोनों API एक ही पैरामीटर पोज़िशन में पूरा YouTube URL, छोटा youtu.be URL, या 11-अक्षर की वीडियो ID स्वीकार करती हैं (वहाँ video_url, यहाँ v)।

Q03

अगर मैं TranscriptAPI के फॉर्मैट जैसी कॉमा-सेपरेटेड भाषा सूची भेजूँ तो क्या होगा?

हमारा language पैरामीटर एक सिंगल कोड चाहता है, सूची नहीं। कॉमा-सेपरेटेड वैल्यू शायद मेल नहीं खाएगी - हर कॉल में एक भाषा माँगें, और अगर फॉलबैक चेन चाहिए तो खुद अलग वैल्यू से फिर कोशिश करें।

Q04

क्या मुझे आपकी API से सेगमेंट-लेवल टाइमस्टैम्प मिल सकते हैं?

आज पब्लिक REST API रिस्पॉन्स से नहीं - यह फ्लैट ट्रांसक्रिप्ट टेक्स्ट देता है। अगर आपका माइग्रेशन इस पर निर्भर है, तो इसके उपलब्ध होने का इंतज़ार करें, या वेबसाइट के अपने ट्रांसक्रिप्ट व्यू का इस्तेमाल करें, जो इसे सपोर्ट करता है।

Q05

क्या इसे आज़माना मुफ़्त है?

साइनअप पर 100 मुफ़्त क्रेडिट, बिना कार्ड के - किसी प्लान पर जाने से पहले ट्रांसक्रिप्ट, सर्च, और चैनल एंडपॉइंट्स आज़माने के लिए काफ़ी।