# FlashData YouTube Transcript API

टाइम्सटैम्प्स और एक पूर्ण ट्रांसक्रिप्ट के साथ YouTube ट्रांसक्रिप्ट टेक्स्ट को पुनर्प्राप्त करें। स्वचालित कैप्शन डिफ़ॉल्ट रूप से चुना जाता है।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/sources/youtube_transcript
समीक्षित: 2026-10-23

समापन बिंदु: POST https://data.flashdata.dev/v1/queries/realtime
प्रमाणीकरण: X-API-Key: YOUR_API_KEY
मोड: [Realtime](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/hi/docs/reference/bulk-processing/reference.md)

आवश्यक स्रोत अनुमति: youtube_transcript

YOUR_API_KEY को API कुंजी के साथ बदलें जिसमें इस स्रोत की अनुमति और उपलब्ध क्रेडिट हैं। अपने सर्वर या एजेंट होस्ट पर अनुरोध चलाएं।

[प्रमाणीकरण सेट करें](https://flashdata.dev/hi/docs/guides/headers-and-authentication/reference.md)

[एक ट्रांसक्रिप्ट भाषा चुनें और ट्रैक करें](https://flashdata.dev/hi/docs/guides/youtube-data-guide/reference.md#captions)

<a id="quickstart"></a>

## एक अनुरोध भेजें

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_transcript",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "language": "en",
        "auto": True,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_transcript",
  "video_id": "dQw4w9WgXcQ",
  "params": {
    "language": "en",
    "auto": true
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## पैरामीटर

<a id="parameters-group-0"></a>

### अनुरोध का मुख्य भाग

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | हाँ | — | youtube_transcript को सेट करें।  |
| <a id="parameter-video_id"></a> video_id | string | हाँ | सेट नहीं | 11-character YouTube वीडियो ID, जैसे कि FUfGcZ092b0। अक्षरों, संख्याओं, अंडरस्कोर और हाइफेन्स को स्वीकार करता है। न्यूनतम लंबाई: 11 अधिकतम लंबाई: 11 पैटर्न: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | नहीं | {} | इस अनुरोध के लिए Settings  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | नहीं | सेट नहीं | केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।  |

<a id="parameters-group-1"></a>

### कैप्शन चयन

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string \| array | नहीं | en-orig → en | Omit for English (en-orig, फिर en)। ऑटो = true के साथ, प्रत्येक कोड पहले अपने -orig ट्रैक की कोशिश करता है, फिर अनुरोधित कोड। स्पष्ट -orig कोड और ऑटो = false सही रहते हैं। ऐरेज़ ने 1–10 विशिष्ट भाषाओं का अनुरोध किया। Omit को पसंद करते हैं और वापस आते हैं, एक ट्रैक वापस लौटते हैं। ऑटो = true के साथ, प्रत्येक कोड पहले अपने -orig ट्रैक की कोशिश करता है, फिर अनुरोधित कोड; स्पष्ट -orig कोड और ऑटो = false सही रहते हैं। 1–10 विशिष्ट कोडों की सरणी अनुरोध आदेश में प्रत्येक अनुरोधित भाषा और रिटर्न ट्रैक और प्रति-भाषा त्रुटियों की कोशिश करती है। languageCode चयनित ट्रैक की पहचान करता है; requestedLanguageCode को तब शामिल किया जाता है जब यह अनुरोधित कोड से भिन्न होता है। |
| <a id="parameter-params-auto"></a> params.auto | boolean | नहीं | true | true YouTube-generated captions का चयन करता है; false uploader-provided captions का चयन करता है। यह कैप्शन उत्पत्ति का चयन करता है, भाषा का पता लगाने या नए ट्रांसक्रिप्शन का चयन नहीं करता है।  |

<a id="response"></a>

## परिणाम पढ़ें

सफल JSON प्रतिक्रिया को response.json के रूप में सहेजें। इसे read-response.py के रूप में सहेजें और python 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))
```

## उदाहरण जवाब

रिकॉर्ड उदाहरण; फ़ील्ड और गिनती स्रोत पर निर्भर करती है और इनपुट का अनुरोध करती है।
```json
{
  "source": "youtube_transcript",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "languageName": null,
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0.32,
          "end": 14.58,
          "text": "[Music]"
        },
        {
          "start": 18.8,
          "end": 25.96,
          "text": "We're no strangers to"
        },
        {
          "start": 21.8,
          "end": 29.119,
          "text": "love. You know the rules and so do"
        },
        {
          "start": 25.96,
          "end": 30.279,
          "text": "I. I feel commitments from what I'm"
        },
        {
          "start": 29.119,
          "end": 34.36,
          "text": "thinking"
        },
        {
          "start": 30.279,
          "end": 39.559,
          "text": "of. You wouldn't get this from any other"
        },
        {
          "start": 34.36,
          "end": 43.12,
          "text": "guy. I just want to tell you how I'm"
        },
        {
          "start": 39.559,
          "end": 45.84,
          "text": "feeling. Got to make you understand."
        },
        {
          "start": 43.12,
          "end": 49.2,
          "text": "Never going to give you up. I'm going to"
        },
        {
          "start": 45.84,
          "end": 53.32000000000001,
          "text": "let you down. I'm going to run around"
        },
        {
          "start": 49.2,
          "end": 56.399,
          "text": "and desert you. I'm going to make"
        },
        {
          "start": 53.32,
          "end": 59.879,
          "text": "you say goodbye."
        },
        {
          "start": 56.399,
          "end": 64.04,
          "text": "Tell a lie and hurt"
        },
        {
          "start": 59.879,
          "end": 67.2,
          "text": "you. We've known each other for so"
        },
        {
          "start": 64.04,
          "end": 70.56,
          "text": "long. Your heart's been aching, but"
        },
        {
          "start": 67.2,
          "end": 72.60000000000001,
          "text": "you're too shy to say we don't know"
        },
        {
          "start": 70.56,
          "end": 77.799,
          "text": "what's been going"
        },
        {
          "start": 72.6,
          "end": 81.479,
          "text": "on. We know the game and we're going to"
        },
        {
          "start": 77.799,
          "end": 84.56,
          "text": "play. If you ask me how I'm"
        },
        {
          "start": 81.479,
          "end": 88.32,
          "text": "feeling, don't tell me your truth. to"
        },
        {
          "start": 84.56,
          "end": 88.32000000000001,
          "text": "see. I will give"
        },
        {
          "start": 89.88,
          "end": 94.72,
          "text": "you"
        },
        {
          "start": 91.72,
          "end": 94.72,
          "text": "around"
        },
        {
          "start": 95,
          "end": 99.04,
          "text": "you. I will say"
        },
        {
          "start": 99.56,
          "end": 106.759,
          "text": "goodbye and hurt you. I will give"
        },
        {
          "start": 103.99,
          "end": 108.6,
          "text": "[Music]"
        },
        {
          "start": 106.759,
          "end": 115.92,
          "text": "you"
        },
        {
          "start": 108.6,
          "end": 115.92,
          "text": "around you. I will leave you. I will say"
        },
        {
          "start": 116.439,
          "end": 121.079,
          "text": "goodbye and hurt you."
        },
        {
          "start": 128.319,
          "end": 132.56,
          "text": "Never going to give. Never going to"
        },
        {
          "start": 129.759,
          "end": 134,
          "text": "give."
        },
        {
          "start": 132.56,
          "end": 136.8,
          "text": "Never going to give. Never going to"
        },
        {
          "start": 134,
          "end": 141.04,
          "text": "give."
        },
        {
          "start": 136.8,
          "end": 143.68,
          "text": "We've known each other for so long."
        },
        {
          "start": 141.04,
          "end": 147.51999999999998,
          "text": "Your heart's been aching, but you're too"
        },
        {
          "start": 143.68,
          "end": 148.52,
          "text": "shy to say it. We both know what's been"
        },
        {
          "start": 147.52,
          "end": 152.239,
          "text": "going"
        },
        {
          "start": 148.52,
          "end": 157.8,
          "text": "on. We know the game and we're going to"
        },
        {
          "start": 152.239,
          "end": 161.36,
          "text": "play it. I just want to tell you how I'm"
        },
        {
          "start": 157.8,
          "end": 163.92000000000002,
          "text": "feeling. Got to make you understand."
        },
        {
          "start": 161.36,
          "end": 166.8,
          "text": "Never going to give you up. Never going"
        },
        {
          "start": 163.92,
          "end": 171.28,
          "text": "to let you down. Never going to run"
        },
        {
          "start": 166.8,
          "end": 171.28,
          "text": "around and desert you. Heat."
        },
        {
          "start": 172.33,
          "end": 182.76,
          "text": "[Music]"
        },
        {
          "start": 178.76,
          "end": 182.76,
          "text": "Heat. Heat. Heat."
        },
        {
          "start": 183.39,
          "end": 195.2,
          "text": "[Music]"
        },
        {
          "start": 191.04,
          "end": 197.76,
          "text": "Never going to tell a lie and hurt you."
        },
        {
          "start": 195.2,
          "end": 200.64,
          "text": "Never going to give you up. Never going"
        },
        {
          "start": 197.76,
          "end": 204.239,
          "text": "to let you down. Never going to run"
        },
        {
          "start": 200.64,
          "end": 206.83999999999995,
          "text": "around and desert you. Never going to"
        },
        {
          "start": 204.239,
          "end": 211.879,
          "text": "make you cry. Never going to say"
        },
        {
          "start": 206.84,
          "end": 211.879,
          "text": "goodbye. Never going to say goodbye."
        }
      ],
      "fullText": "[Music] We're no strangers to love. You know the rules and so do I. I feel commitments from what I'm thinking of. You wouldn't get this from any other guy. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. I'm going to let you down. I'm going to run around and desert you. I'm going to make you say goodbye. Tell a lie and hurt you. We've known each other for so long. Your heart's been aching, but you're too shy to say we don't know what's been going on. We know the game and we're going to play. If you ask me how I'm feeling, don't tell me your truth. to see. I will give you around you. I will say goodbye and hurt you. I will give [Music] you around you. I will leave you. I will say goodbye and hurt you. Never going to give. Never going to give. Never going to give. Never going to give. We've known each other for so long. Your heart's been aching, but you're too shy to say it. We both know what's been going on. We know the game and we're going to play it. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. Never going to let you down. Never going to run around and desert you. Heat. [Music] Heat. Heat. Heat. [Music] Never going to tell a lie and hurt you. Never going to give you up. Never going to let you down. Never going to run around and desert you. Never going to make you cry. Never going to say goodbye. Never going to say goodbye."
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:45:44.040Z"
}
```

## एकाधिक भाषाएँ

ट्रैक और प्रति भाषा त्रुटियों को प्राप्त करने के लिए एक भाषा सरणी भेजें। यह उदाहरण अंग्रेजी उपलब्ध और स्पेनिश अनुपलब्ध है।

```json
{
  "source": "youtube_transcript",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": true
  }
}
```

`results[0]`:

```json
{
  "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"
    }
  ]
}
```

## प्रतिक्रिया क्षेत्र

| फील्ड | प्रकार | विवरण |
| --- | --- | --- |
| source | string | अनुरोधित API स्रोत। |
| status | string | जब रियलटाइम अनुरोध सफल होता है तो किया जाता है। |
| created_at | string | ISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय। |
| usage.credits | number | आपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट। |
| results[0].videoId | string | अनुरोधित वीडियो ID. |
| results[0].languageCode | string | वास्तविक चयनित कैप्शन ट्रैक कोड, जैसे एन-ऑर्ग। |
| results[0].languageName | string · nullable | उपलब्ध होने पर भाषा प्रदर्शित नाम। |
| results[0].requestedLanguageCode | string · optional | अनुरोधित कोड जब यह languageCode से भिन्न होता है, उदाहरण के लिए जब एन-ऑर्ग चुना गया था। |
| results[0].isAutoGenerated | boolean | चाहे चयनित कैप्शन स्वचालित रूप से उत्पन्न हो। |
| results[0].segments | array | क्रोनोलॉजिकल क्रम में कैप्शन खंड। |
| results[0].segments[].start | number | सेगमेंट सेकंड में समय शुरू होता है। |
| results[0].segments[].end | number | सेकंड में सेगमेंट का अंत समय। |
| results[0].segments[].text | string | कैप्शन टेक्स्ट। |
| results[0].fullText | string | सभी खंड पाठ एक ट्रांसक्रिप्ट में शामिल हो गए। |
| results[0].tracks | array · optional | केवल भाषा सरणी के लिए। अनुरोध आदेश में उपलब्ध ट्रैक; प्रत्येक में ऊपर सूचीबद्ध एकल ट्रैक फ़ील्ड हैं। |
| results[0].errors | array · optional | केवल भाषा सरणी के लिए। अनुरोध आदेश में विफल भाषाओं। जब प्रत्येक ट्रैक सफल होता है तो खाली। |
| results[0].errors[].languageCode | string | अनुरोधित भाषा जो विफल हो गई। |
| results[0].errors[].code | string | जब चयनित ट्रैक मौजूद नहीं है तो language_unavailable; retrieval_failed जब इसे डाउनलोड नहीं किया जा सकता है या पार्स किया जा सकता है। |
| results[0].errors[].message | string | भाषा विफलता का विवरण। |

- API पहले से ही YouTube पर उपलब्ध कैप्शन पढ़ता है। यह नए ट्रांसक्रिप्ट उत्पन्न नहीं करता है या स्वचालित और अपलोडर-निर्मित कैप्शन के बीच वापस गिरता है।
- एक स्ट्रिंग भाषा एकल ट्रैक प्रतिक्रिया रखता है। एक सरणी, यहां तक कि ["en"], शीर्ष स्तर के languageCode, खंडों और fullText के बजाय ट्रैक और त्रुटियों को लौटाता है। प्रत्येक ट्रैक में उन फ़ील्ड शामिल हैं। ऑटो प्रत्येक भाषा पर लागू होता है।
- भाषाओं की सूची के लिए, विफल ट्रैक देखने के लिए errors देखें। अगर कोई भी ट्रैक प्राप्त नहीं होता, तो अनुरोध विफल होता है और आरक्षित क्रेडिट वापस कर दिए जाते हैं। वीडियो से डेटा निकालने में विफलता या समय सीमा समाप्त होने पर भी अनुरोध विफल होता है।
- वास्तविक समय, async, बैच और थोक के लिए उपलब्ध है। Bulk निर्यात प्रति वीडियो एक रिकॉर्ड के साथ JSONL रहते हैं, जिसमें इसके ट्रैक और त्रुटियां शामिल हैं। Accept और X-Respond-With सामान्य रूप से लागू होते हैं।

## जवाब के फ़ॉर्मैट

उत्तर डिफ़ॉल्ट रूप से JSON का उपयोग करते हैं। इन वैकल्पिक शीर्षलेखों के साथ एक और प्रारूप चुनें।

- Accept: application/json (डिफ़ॉल्ट) या text/plain. सादा पाठ एक पठनीय, इंडेंट लेआउट में समान फ़ील्ड प्रस्तुत करता है।
- X-Respond-With: markdown. मूल क्षेत्रों के लिए unset छोड़ दें। Markdown या तो प्रतिक्रिया प्रारूप के साथ काम करता है।

Markdown वास्तविक समय के प्रश्नों और पूर्ण परिणाम के लिए उपलब्ध है।

नीचे दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं।

[अनुरोध और प्रतिक्रिया प्रारूप उदाहरण](https://flashdata.dev/hi/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API की बुनियादी बातें

अनुरोध बिल्डर और उपरोक्त उदाहरण इस स्रोत के पैरामीटर का उपयोग करते हैं। साझा प्रस्तुतीकरण, स्थिति और परिणाम चरणों के लिए नीचे Python और cURL उदाहरणों का उपयोग करें। एक Batch शरीर एक JSON वस्तु है जिसमें क्वेरीज़ शामिल है; प्रत्येक आइटम अपने खुद के काम को लौटा देता है ID.

- [Async अनुरोध और रसीद](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [नौकरी की स्थिति चेक करें](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [प्राप्त करने के परिणाम](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON अनुरोध](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch)
- [Bulk प्रोसेसिंग API](https://flashdata.dev/hi/docs/reference/bulk-processing/reference.md)
- [इस स्रोत के लिए Bulk वर्कफ़्लो बनाएं](https://flashdata.dev/hi/docs/reference/bulk-processing/reference.md?source=youtube_transcript#playground)
- [ग्राहक OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## पूर्णता अधिसूचना

- [पूरा वेबहुक प्राप्त करना और सत्यापित करना](https://flashdata.dev/hi/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## समस्या निवारण

- [त्रुटियाँ और स्टेटस कोड](https://flashdata.dev/hi/docs/errors/reference.md#status-codes)
- [कब्ज़ा](https://flashdata.dev/hi/docs/errors/reference.md#retries)

## संबंधित एपीआई

- [YouTube Captions API](https://flashdata.dev/hi/docs/sources/youtube_captions/reference.md)
- [YouTube वीडियो मेटाडाटा API](https://flashdata.dev/hi/docs/sources/youtube_metadata/reference.md)
