दस्तावेज़ देखें
API संदर्भ
YouTube Transcript API
टाइम्सटैम्प्स और एक पूर्ण ट्रांसक्रिप्ट के साथ YouTube ट्रांसक्रिप्ट टेक्स्ट को पुनर्प्राप्त करें। स्वचालित कैप्शन डिफ़ॉल्ट रूप से चुना जाता है।
अनुरोध बनाएँ
11-character ID वीडियो URL से, पूर्ण URL नहीं।
एन-ऑर्गिज़ की कोशिश करने के लिए खाली छोड़ दें, फिर एन, और एक ट्रैक वापस लौटें। या एक कोड दर्ज करें या कमाओ द्वारा अलग किए गए 10 विशिष्ट कोड तक।
https://data.flashdata.dev/v1/queries/realtimeपैरामीटर
भेजें source और video_id शीर्ष स्तर पर। स्रोत विकल्प params. वैकल्पिक क्षेत्रों को छोड़ा जा सकता है।
अनुरोध का मुख्य भाग
sourcestring / ज़रूरी- youtube_transcript को सेट करें।
video_idstring / ज़रूरी- 11-character YouTube वीडियो ID, जैसे कि FUfGcZ092b0। अक्षरों, संख्याओं, अंडरस्कोर और हाइफेन्स को स्वीकार करता है।Exactly 11 वर्णडिफ़ॉल्ट:
सेट नहींस्वीकृत प्रारूप
^[A-Za-z0-9_-]{11}$ paramsobject / वैकल्पिक- इस अनुरोध के लिए Settingsडिफ़ॉल्ट:
{} callback_urlstring · nullable / वैकल्पिक- केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।डिफ़ॉल्ट:
सेट नहीं
कैप्शन चयन
params.languagestring | array / वैकल्पिक- Omit for English (en-orig, फिर en)। ऑटो = true के साथ, प्रत्येक कोड पहले अपने -orig ट्रैक की कोशिश करता है, फिर अनुरोधित कोड। स्पष्ट -orig कोड और ऑटो = false सही रहते हैं। ऐरेज़ ने 1–10 विशिष्ट भाषाओं का अनुरोध किया।डिफ़ॉल्ट:
en-orig → en params.autoboolean / वैकल्पिक- true YouTube-generated captions का चयन करता है; false uploader-provided captions का चयन करता है। यह कैप्शन उत्पत्ति का चयन करता है, भाषा का पता लगाने या नए ट्रांसक्रिप्शन का चयन नहीं करता है।
trueयाfalseडिफ़ॉल्ट:true
जवाब
Realtime रिटर्न status: done. पर स्रोत उत्पादन पढ़ें results[0]; usage.credits चार्ज रिकॉर्ड करता है।
शामिल ट्रांसक्रिप्ट के लिए टाइमटाम्प्ड टेक्स्ट और fullText के लिए सेगमेंट पढ़ें। सेगमेंट स्टार्ट एंड एंड सेकंड हैं; languageCode और isAutoGenerated चयनित ट्रैक की पहचान करते हैं।
परिणाम पढ़ें
सफल JSON प्रतिक्रिया को response.json के रूप में सहेजें। इसे read-response.py के रूप में सहेजें और python read-response.py चलाएं। यह केवल Python के मानक पुस्तकालय का उपयोग करता है और कोई नया अनुरोध नहीं करता है।
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {
"tracks": result.get("tracks", [result]),
"errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))Omit भाषा en-orig पसंद करने के लिए और वापस करने के लिए वापस आते हैं, एक ट्रैक वापस लौटते हैं। ऑटो = true के साथ, प्रत्येक अनुरोधित कोड अपने -orig ट्रैक को पसंद करता है, फिर सादे कोड; स्पष्ट -orig और ऑटो = false सही रहते हैं। ऐरे प्रत्येक अनुरोधित भाषा की कोशिश करते हैं और क्रम में ट्रैक और त्रुटियों को वापस करते हैं। languageCode चयनित ट्रैक की पहचान करता है; जब यह अलग होता है तो requestedLanguageCode को शामिल किया गया है।
भाषाओं की सूची के लिए, विफल ट्रैक देखने के लिए errors देखें। अगर कोई भी ट्रैक प्राप्त नहीं होता, तो अनुरोध विफल होता है और आरक्षित क्रेडिट वापस कर दिए जाते हैं। वीडियो से डेटा निकालने में विफलता या समय सीमा समाप्त होने पर भी अनुरोध विफल होता है।
स्वचालित कैप्शन के लिए true को ऑटो डिफॉल्ट। uploader-provided captions के लिए false सेट करें। API कभी भी कैप्शन स्रोतों को स्विच नहीं करता है।
API ने मौजूदा YouTube कैप्शन को पढ़ा; यह नए ट्रांसक्रिप्ट उत्पन्न नहीं करता है। डिफ़ॉल्ट प्रतिक्रिया में सामान्यीकृत JSON टेक्स्ट शामिल है; Accept सादे पाठ का चयन कर सकते हैं और X-Respond-With: मार्कडाउन Markdown का चयन करता है। languageName को null कहा जा सकता है।
एकाधिक भाषाएँ
ट्रैक और प्रति भाषा त्रुटियों को प्राप्त करने के लिए एक भाषा सरणी भेजें। यह उदाहरण अंग्रेजी उपलब्ध और स्पेनिश अनुपलब्ध है।
{
"source": "youtube_transcript",
"video_id": "jNQXAC9IVRw",
"params": {
"language": [
"en",
"es"
],
"auto": true
}
}{
"videoId": "jNQXAC9IVRw",
"isAutoGenerated": true,
"tracks": [
{
"videoId": "jNQXAC9IVRw",
"languageCode": "en-orig",
"requestedLanguageCode": "en",
"languageName": null,
"isAutoGenerated": true,
"segments": [
{
"start": 0,
"end": 1.5,
"text": "Hello world."
}
],
"fullText": "Hello world."
}
],
"errors": [
{
"languageCode": "es",
"code": "language_unavailable",
"message": "Auto-generated subtitles not available for language: es"
}
]
}सभी प्रतिक्रिया क्षेत्र
| फील्ड | विवरण |
|---|---|
sourcestring | अनुरोधित API स्रोत। |
statusstring | जब रियलटाइम अनुरोध सफल होता है तो किया जाता है। |
created_atstring | ISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय। |
usage.creditsnumber | आपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट। |
results[0].videoIdstring | अनुरोधित वीडियो ID. |
results[0].languageCodestring | वास्तविक चयनित कैप्शन ट्रैक कोड, जैसे एन-ऑर्ग। |
results[0].languageNamestring · nullable | उपलब्ध होने पर भाषा प्रदर्शित नाम। |
results[0].requestedLanguageCodestring · optional | अनुरोधित कोड जब यह languageCode से भिन्न होता है, उदाहरण के लिए जब एन-ऑर्ग चुना गया था। |
results[0].isAutoGeneratedboolean | चाहे चयनित कैप्शन स्वचालित रूप से उत्पन्न हो। |
results[0].segmentsarray | क्रोनोलॉजिकल क्रम में कैप्शन खंड। |
results[0].segments[].startnumber | सेगमेंट सेकंड में समय शुरू होता है। |
results[0].segments[].endnumber | सेकंड में सेगमेंट का अंत समय। |
results[0].segments[].textstring | कैप्शन टेक्स्ट। |
results[0].fullTextstring | सभी खंड पाठ एक ट्रांसक्रिप्ट में शामिल हो गए। |
results[0].tracksarray · optional | केवल भाषा सरणी के लिए। अनुरोध आदेश में उपलब्ध ट्रैक; प्रत्येक में ऊपर सूचीबद्ध एकल ट्रैक फ़ील्ड हैं। |
results[0].errorsarray · optional | केवल भाषा सरणी के लिए। अनुरोध आदेश में विफल भाषाओं। जब प्रत्येक ट्रैक सफल होता है तो खाली। |
results[0].errors[].languageCodestring | अनुरोधित भाषा जो विफल हो गई। |
results[0].errors[].codestring | जब चयनित ट्रैक मौजूद नहीं है तो language_unavailable; retrieval_failed जब इसे डाउनलोड नहीं किया जा सकता है या पार्स किया जा सकता है। |
results[0].errors[].messagestring | भाषा विफलता का विवरण। |
ऊपर दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं। JSON, सादे पाठ और Markdown प्रारूप.
Async एक नौकरी रसीद लौटाता है; बैच प्रति एक रिटर्न देता है वीडियो ID. प्रत्येक नौकरी की स्थिति की जांच करें और लौटाए गए लिंक का उपयोग करके अपने परिणाम पुनर्प्राप्त करें।
Async & बैच जीवनचक्र
सबमिशन एक रसीद लौटाता है, परिणाम नहीं देता है। Async एक नौकरी बनाता है; बैच में एक अलग काम देता है queries[] प्रत्येक स्वीकृत क्वेरी के लिए। प्रत्येक नौकरी को स्वतंत्र रूप से ट्रैक और पुनर्प्राप्त करें।
प्रस्तुत करना data.flashdata.dev; नौकरी की स्थिति और परिणाम पढ़ने से api.flashdata.dev उसी X-API-Key के साथ। लिंक्ड API मूलभूत उदाहरण Python और cURL का उपयोग करते हैं।
1. नौकरी बचाओ IDs
इस स्रोत के अनुरोध फ़ील्ड को Async पर स्विच करते समय रखें। Batch के लिए, प्रत्येक अनुरोध को एक JSON ऑब्जेक्ट की क्वेरी सरणी के अंदर रखें। प्रत्येक वापसी कार्य ID बचाओ।
2. स्थिति की जाँच करें
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: देरी और सम्मान के साथ मतदानRetry-Afterजब उपस्थित हो।completed: परिणाम प्राप्त करें।failed: निरीक्षणjob.error.job.status पढ़ें, प्रस्तुतीकरण रसीद की स्थिति नहीं।
नौकरी की स्थिति API संदर्भ3. Fetch परिणाम
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsपूरा होने के बाद, परिणाम को प्रमाणित करें, फिर अपने API कुंजी के बिना 302 संग्रहण URL प्राप्त करें। JSON को 24 घंटे पूरा होने के भीतर सहेजें।
Fetch परिणाम · Python और cURL · जवाब के फ़ॉर्मैट
परिणाम डाउनलोड API
मतदान और मौजूदा परिणाम प्राप्त करने के लिए क्वेरी क्रेडिट का उपभोग नहीं करते हैं। एक मतदान टाइमआउट नौकरी को रद्द नहीं करता है: डुप्लिकेट बिलेबल वर्क जमा करने के बजाय अपने ID को रखें। त्रुटि कोड और पुनर्प्राप्ति व्यवहार.
पूरा होने पर वेबहुक
क्वेरी के अनुसार सदस्यता लें
सेट callback_url एक async अनुरोध के शीर्ष स्तर पर, या प्रत्येक क्वेरी के अंदर एक बैच में, बाहर params. कोई अलग वेबहुक पंजीकरण अनुरोध की आवश्यकता नहीं है। Realtime अनुरोध कॉलबैक नहीं भेजता है।
पोर्ट 443 पर एक सार्वजनिक HTTPS URL का उपयोग करें। FlashData POSTs प्रत्येक नौकरी के लिए एक अधिसूचना तक पहुँचने के लिए completed या failed; इस घटना में लिंक शामिल हैं, न कि परिणाम स्वयं।
स्वीकार करना और सत्यापित करना
वापसी 2xx इस घटना को स्वीकार करने के बाद। Deduplicate by Deduplicate delivery_id, भी भेजा गया X-Delivery-Id. पुनर्निर्देशन का पालन नहीं किया जाता।
विफल प्रसव एक्सोनेंशियल बैकऑफ़ के साथ वापसी, अप करने के लिए 8 कुल प्रयास करता है और अधिक पूरा होने के बाद 24 घंटे. मतदान को गिरने के रूप में रखें।
कॉलबैक को इस्तीफा नहीं दिया जाता है। नौकरी की पुष्टि करें ID, स्रोत और टर्मिनल स्थिति के माध्यम से प्रमाणित स्थिति समापन बिंदु अधिसूचना को संसाधित करने से पहले। वितरण ID, deduplication के लिए है, प्रामाणिकता का प्रमाण नहीं है।
उदाहरण वेबहुक घटना और फ़ील्ड
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_transcript",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| फील्ड | विवरण |
|---|---|
delivery_idstring | स्थिर वितरण पहचानकर्ता। इस मूल्य का उपयोग करके Deduplicate नोटिफिकेशन; इसे X-Delivery-Id हेडर में भी भेजा जाता है। |
idstring | नौकरी ID |
sourcestring | अनुरोधित डेटा स्रोत। |
statusstring | पूरा या विफल हो गया। |
linksarray | स्थिति और परिणाम लिंक। अधिसूचनाओं में परिणाम सामग्री या एक API कुंजी शामिल नहीं है। |
links[].relstring | स्वयं या परिणाम। |
links[].hrefstring | पूर्ण प्रबंधन API URL; अपने API कुंजी के साथ प्रमाणित। |
links[].methodstring | GET. |
Bulk फ़ाइल प्रसंस्करण
प्रत्येक पंक्ति में एक वीडियो ID अपलोड करें और स्रोत के साथ Bulk जॉब बनाएं: youtube_transcript. साझा विकल्प फ़ाइल में प्रत्येक ID पर लागू होते हैं।
स्रोत विकल्प: भाषा, ऑटो. उन्हें Bulk नौकरी बनाने के विकल्प में रखें।
पूरा संग्रह को एक प्रकट और gzip-compressed NDJSON परिणाम भागों के रूप में पुनर्प्राप्त करें। डेटा स्रोत Bulk नौकरी बनाने के दौरान options.result_storage की स्थापना करके आपके क्लाउड स्टोरेज में परिणाम भागों को भी वितरित कर सकते हैं। पूरे Bulk नौकरी पूरा होने के बाद 24 घंटों के भीतर प्रकट होने और भागों को बचाओ।
Bulk प्रसंस्करण API · Python और cURL · Batch JSON अनुरोध
इस स्रोत के लिए Bulk वर्कफ़्लो बनाएं · रोकें, फिर से शुरू करें और पुनर्प्राप्त करें
त्रुटि
यदि अनुरोधित ट्रैक अनुपलब्ध है, तो मेटाडाटा API के transcriptLanguages का निरीक्षण करें और समर्थित language/track प्रकार स्पष्ट रूप से अनुरोध करें। एक अनुपलब्ध चयन को अपरिवर्तनित करने से उस ट्रैक का निर्माण नहीं होगा।
Metadata के साथ उपलब्ध कैप्शन भाषाओं की जाँच करें. एक नया अनुरोध क्वेरी क्रेडिट का उपयोग करता है; एक ट्रैक को बदलने से मौजूदा नौकरी को संशोधित नहीं किया जाता है।
प्रमाणीकरण, संतुलन, अनुरोध प्रारूप और दर सीमा विफलताओं के लिए, साझा त्रुटि संदर्भ का उपयोग करें। अभी भी एक नौकरी का निर्माण हो सकता है; पुनः प्रयास करने से पहले मौजूदा काम की जांच करें।
चरण-दर-चरण गाइड: एक ट्रांसक्रिप्ट भाषा चुनें और ट्रैक करें
कीमतें
| योजना | उपयोग की दरेंप्रति 1,000 मानक अनुरोध | सदस्यता | प्रति बिलिंग अवधि में क्रेडिट शामिल |
|---|---|---|---|
| इस्तेमाल के अनुसार भुगतान | $0.50 | कोई मासिक शुल्क नहीं | ज़रूरत पर रिचार्ज करें |
| Micro | $0.40 | $49.00 / महीना | 1,000 क्रेडिट्स ($50.00 of API उपयोग) में शामिल |
| Starter | $0.35 | $199.00 / महीना | 4,000 क्रेडिट्स ($200.00 of API उपयोग) में शामिल |
| Pro | $0.30 | $499.00 / महीना | 10,000 क्रेडिट्स ($500.00 of API उपयोग) में शामिल |
| Scale | $0.25 | $999.00 / महीना | 20,000 क्रेडिट्स ($1,000.00 of API उपयोग) में शामिल |
| Business | $0.20 | $1,999.00 / महीना | 40,000 क्रेडिट्स ($2,000.00 of API उपयोग) में शामिल |
एक खाता प्लान। तीनों उत्पादों में साझा क्रेडिट। शामिल क्रेडिट से चुकाए गए उपयोग पर दोबारा शुल्क नहीं लगता।
वर्तमान मूल्य और योजना सीमा