# FlashData YouTube Channel API

एक YouTube चैनल प्रोफाइल और इसके हाल के वीडियो को हैंडल द्वारा पुनर्प्राप्त करें, जिसमें ग्राहक गिनती, चैनल चित्र और वीडियो विवरण शामिल हैं।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/sources/youtube_channel
समीक्षित: 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)

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

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#channel)

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

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

### Python

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

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_channel",
    "handle": "@jawed",
    "params": {
        "video_limit": 10,
    },
}

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_channel",
  "handle": "@jawed",
  "params": {
    "video_limit": 10
  }
}
FLASHDATA_JSON
```

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

## पैरामीटर

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

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

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | हाँ | — | youtube_channel को सेट करें।  |
| <a id="parameter-handle"></a> handle | string | हाँ | सेट नहीं | चैनल हैंडल, जैसे @jawed। @ prefix वैकल्पिक है। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 100 |
| <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-video_limit"></a> params.video_limit | integer | नहीं | 20 | इसमें शामिल होने के लिए अधिकतम वीडियो। कम लागत उपलब्ध है। न्यूनतम: 1 अधिकतम: 100 |

<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 = {
    "channelId": result.get("channelId"),
    "name": result.get("name"),
    "videos": [
        {"videoId": item.get("videoId"), "title": item.get("title")}
        for item in result.get("videos", [])
    ],
}
print(json.dumps(output, ensure_ascii=False, indent=2))
```

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

रिकॉर्ड उदाहरण; फ़ील्ड और गिनती स्रोत पर निर्भर करती है और इनपुट का अनुरोध करती है।
```json
{
  "source": "youtube_channel",
  "status": "done",
  "results": [
    {
      "channelId": "UC4QobU6STFB0P71PMvOGN5A",
      "channelHandle": "@jawed",
      "name": "jawed",
      "description": "",
      "subscriberCount": 6580000,
      "videoCount": 1,
      "viewCount": null,
      "avatarUrl": "https://yt3.googleusercontent.com/uI3VE4PVqvCy0xnWLqMJnEzyBUm3T8VHOCp4ee-1RxdHqKXCdUE_qXYQnpf9AfuEoIPactVyDhM=s0",
      "bannerUrl": null,
      "channelUrl": "https://www.youtube.com/channel/UC4QobU6STFB0P71PMvOGN5A",
      "videos": [
        {
          "videoId": "jNQXAC9IVRw",
          "title": "Me at the zoo",
          "duration": 19,
          "viewCount": 431000000,
          "uploadDate": null,
          "thumbnail": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE2COADEI4CSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgBvgKAAvABigIMCAAQARhVIFkoZTAP&rs=AOn4CLDkGJrAGBspJ5G6u9b7tutsHbloEg"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:41:47.218Z"
}
```

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

| फील्ड | प्रकार | विवरण |
| --- | --- | --- |
| source | string | अनुरोधित API स्रोत। |
| status | string | जब रियलटाइम अनुरोध सफल होता है तो किया जाता है। |
| created_at | string | ISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय। |
| usage.credits | number | आपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट। |
| results[0].channelId | string | चैनल ID |
| results[0].channelHandle | string | चैनल हैंडल। |
| results[0].name | string | चैनल का नाम |
| results[0].description | string | चैनल विवरण। |
| results[0].subscriberCount | number · nullable | अभिदाता गणना। |
| results[0].videoCount | number · nullable | कुल चैनल वीडियो गिनती। |
| results[0].viewCount | number · nullable | उपलब्ध होने पर चैनल दृश्य गणना। |
| results[0].avatarUrl | string · nullable | चैनल अवतार URL |
| results[0].bannerUrl | string · nullable | चैनल बैनर URL |
| results[0].channelUrl | string | चैनल पेज URL |
| results[0].videos | array | हाल के वीडियो, video_limit प्रविष्टियों तक। |
| results[0].videos[].videoId | string | वीडियो ID |
| results[0].videos[].title | string | वीडियो शीर्षक। |
| results[0].videos[].duration | number · nullable | सेकंड में अवधि |
| results[0].videos[].viewCount | number · nullable | गिनती देखें। |
| results[0].videos[].uploadDate | string · nullable | अपलोड की तारीख। |
| results[0].videos[].thumbnail | string · nullable | वीडियो थंबनेल URL. |

- चैनल सांख्यिकी और चित्र अनुपलब्ध हो सकते हैं। videoCount चैनल का वर्णन करता है; वीडियो सरणी में केवल अनुरोधित हाल के वीडियो शामिल हैं।

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

उत्तर डिफ़ॉल्ट रूप से 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)
- [ग्राहक 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 वीडियो मेटाडाटा API](https://flashdata.dev/hi/docs/sources/youtube_metadata/reference.md)
- [YouTube Search API](https://flashdata.dev/hi/docs/sources/youtube_search/reference.md)
