# FlashData YouTube Channel API

¡Retrieve a YouTube profil saluran dan video-video terbarunya dengan menangani, termasuk penghitungan pelanggan, gambar saluran dan rincian video.

Referensi boonical: https://flashdata.dev/ms/docs/sources/youtube_channel
Diulas: 2026-10-23

Titik akhir Ukur: POST https://data.flashdata.dev/v1/queries/realtime
Pengesahan: X-API-Key: YOUR_API_KEY
Mode: [Realtime](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)

Izin sumber yang dibutuhkan: youtube_channel

Megantikan YOUR_API_KEY dengan kunci API yang memiliki izin sumber ini dan kredit yang tersedia. Permintaan run run pada server atau agen host anda.

[Otentikasi Gagal](https://flashdata.dev/ms/docs/guides/headers-and-authentication/reference.md)

[Berkarya dengan saluran dan video terbarunya](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#channel)

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

## Upn permintaan

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

## Parameter

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

### Badan permintaan

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Ditetapkan untuk youtube_channel.  |
| <a id="parameter-handle"></a> handle | string | Ya | Tidak Diset | Handle channel, seperti @jawed. Awalan @ adalah opsional. Panjang Min: 1. Panjang maksimum: 100. |
| <a id="parameter-params"></a> params | object | Tak ada | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tak ada | Tidak Diset | Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.  |

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

### Pemilihan video

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-video_limit"></a> params.video_limit | integer | Tak ada | 20 | Video maksimum untuk dimasukkan. Ada yang lebih kecil. Minimal: 1. Maximum: 100. |

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

## Baca hasilnya

Simpan respon JSON yang sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan perpustakaan standar Python dan tidak membuat permintaan baru.

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

## Contoh respons

Contoh terrekam; bidang dan hitungan bergantung pada sumber dan masukan yang diminta.
```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"
}
```

## Medan tanggapan palsu

| Ukrainian | Jenis | Keterangan |
| --- | --- | --- |
| source | string | Sumber API yang diminta. |
| status | string | Hal ini dilakukan ketika permintaan realtime berhasil. |
| created_at | string | Waktu penciptaan responsi kreasi dalam format ISO 8601. |
| usage.credits | number | Penghargaan atas permintaan itu, berdasarkan rencanamu. |
| results[0].channelId | string | Saluran ID. |
| results[0].channelHandle | string | Handle Channel. |
| results[0].name | string | Nama saluran. |
| results[0].description | string | Keterangan Saluran. |
| results[0].subscriberCount | number · nullable | Langganan count. |
| results[0].videoCount | number · nullable | Jumlah jumlah video channel. |
| results[0].viewCount | number · nullable | Jumlah tampilan saluran bila tersedia. |
| results[0].avatarUrl | string · nullable | avatar saluran URL. |
| results[0].bannerUrl | string · nullable | Banner saluran URL. |
| results[0].channelUrl | string | Halaman saluran URL. |
| results[0].videos | array | Video terbaru, sampai ke entri video_limit. |
| results[0].videos[].videoId | string | Video ID. |
| results[0].videos[].title | string | Video judul. |
| results[0].videos[].duration | number · nullable | Durasi dalam hitungan detik. |
| results[0].videos[].viewCount | number · nullable | View count. |
| results[0].videos[].uploadDate | string · nullable | Tanggal unggahan. |
| results[0].videos[].thumbnail | string · nullable | thumbnail video URL. |

- Statistik saluran dan gambar mungkin tidak tersedia. videoCount menggambarkan saluran; array video hanya berisi video-video terbaru yang diminta.

## Format respons

Sambutan menggunakan JSON secara default. Memikul format lain dengan header opsional ini.

- Accept: application/json (default) OR atau ORANG text/plain. Teks Plain menyajikan bidang yang sama dalam tata letak yang dapat dibaca dan diindentasi.
- X-Respond-With: markdown. Jangan sampai tidak sesuai dengan bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk pertanyaan waktu nyata dan hasil selesai.

Bidang-bidang di bawah ini menggambarkan respon JSON baku.

[Contoh format permintaan dan tanggapan](https://flashdata.dev/ms/docs/guides/response-formats/reference.md#headers)

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

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

## Asas API

Waaswan permintaan pembangun dan contoh di atas menggunakan parameter sumber ini. Andaikata menggunakan contoh Python dan cURL di bawah ini untuk penyerahan bersama, status dan langkah hasil. Tubuh Batch adalah sebuah objek JSON yang berisi kueri; setiap item mengembalikan pekerjaannya sendiri ID.

- [Permintaan dan penerimaan Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async)

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

- [Periksa status pekerjaan](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#status)

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

- [Hasil yang telah selesai](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#results)
- [Permintaan Batch JSON](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)
- [BukaAPI Pelanggan oleh:](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian hasil Pengundian

- [Terima dan sahkan pelengkapan webhooks](https://flashdata.dev/ms/docs/guides/async-batch/reference.md#webhooks)

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

## Penerjemahan Masalah

- [Ralat dan kod status](https://flashdata.dev/ms/docs/errors/reference.md#status-codes)
- [Bila hendak mencoba lagi](https://flashdata.dev/ms/docs/errors/reference.md#retries)

## API yang berkaitan dengan anak - anak

- [YouTube Data Meta Video API](https://flashdata.dev/ms/docs/sources/youtube_metadata/reference.md)
- [YouTube Search API](https://flashdata.dev/ms/docs/sources/youtube_search/reference.md)
