# FlashData YouTube Channel API

Ambil profil saluran YouTube dan videonya yang baru-baru ini dengan menangani, termasuk jumlah pelanggan, gambar saluran dan rincian video.

Referensi kanonikal: https://flashdata.dev/id/docs/sources/youtube_channel
Diulas: 2026-10-23

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

Izin sumber yang diperlukan: youtube_channel

Ganti kunci YOUR_API_KEY dengan kunci API yang memiliki hak sumber ini dan kredit yang tersedia. Jalankan permintaan pada server atau agen host.

[Atur otentikasi](https://flashdata.dev/id/docs/guides/headers-and-authentication/reference.md)

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

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

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

### Isi permintaan

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Set ke youtube_channel.  |
| <a id="parameter-handle"></a> handle | string | Ya | Tak ditata | Kendali saluran, seperti @ jawed. @ prefix adalah opsional. Panjang Min: 1. Panjang Max: 100. |
| <a id="parameter-params"></a> params | object | Tidak | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tidak | Tak ditata | Async dan batch saja. Publik HTTPS pelengkapan URL di port 443, sampai 2,048 karakter. Tak ada kredensial pengguna atau fragmen URL. Omit, gunakan null atau string kosong untuk tanpa pemberitahuan. Dalam batch, set ini pada setiap query, di luar param.  |

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

### Seleksi video

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-video_limit"></a> params.video_limit | integer | Tidak | 20 | Video maksimum untuk dimasukan. Sedikit mungkin tersedia. Minimum: 1. Maksimum: 100. |

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

## Baca hasilnya

Simpan respon JSON sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan Python perpustakaan standar 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 direkam; ruas dan jumlah 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"
}
```

## Ruas respon

| Ruas | Jenis | Deskripsi |
| --- | --- | --- |
| source | string | Sumber yang diminta API. |
| status | string | dilakukan ketika permintaan realtime sukses. |
| created_at | string | Waktu pembuatan respon dalam format ISO 8601. |
| usage.credits | number | Kredit dikenakan biaya untuk permintaan, berdasarkan rencana Anda. |
| results[0].channelId | string | Saluran ID. |
| results[0].channelHandle | string | Kandang saluran. |
| results[0].name | string | Nama saluran. |
| results[0].description | string | Deskripsi saluran. |
| results[0].subscriberCount | number · nullable | Jumlah pelanggan. |
| results[0].videoCount | number · nullable | Jumlah total saluran video. |
| results[0].viewCount | number · nullable | Jumlah tampilan saluran saat tersedia. |
| results[0].avatarUrl | string · nullable | Avatar Channel URL. |
| results[0].bannerUrl | string · nullable | Panji Channel URL. |
| results[0].channelUrl | string | Halaman saluran URL. |
| results[0].videos | array | Video terbaru, hingga entri video_limit. |
| results[0].videos[].videoId | string | Video ID. |
| results[0].videos[].title | string | Judul video. |
| results[0].videos[].duration | number · nullable | Durasi dalam hitungan detik. |
| results[0].videos[].viewCount | number · nullable | Lihat hitungan. |
| results[0].videos[].uploadDate | string · nullable | Upload date. |
| results[0].videos[].thumbnail | string · nullable | Video thumbnail URL. |

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

## Format respons

Respon menggunakan JSON secara baku. Pilih format lain dengan header opsional ini.

- Accept: application/json (baku) atau text/plain. Teks biasa menyajikan ruas yang sama dalam tata letak yang dapat dibaca, tidak terbaca.
- X-Respond-With: markdown. Tinggalkan unset untuk bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk kueri realtime dan hasil selesai.

Bidang di bawah ini menjelaskan respon baku JSON.

[Permohonan dan contoh format respon](https://flashdata.dev/id/docs/guides/response-formats/reference.md#headers)

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

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

## Dasar-dasar API

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

- [Async permintaan dan tanda terima](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#async)

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

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

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

- [Mengambil hasil selesai](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#results)
- [permintaan Batch JSON](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md#batch)
- [Pelanggan OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian

- [Menerima dan memverifikasi pelengkapan webhooks](https://flashdata.dev/id/docs/guides/async-batch/reference.md#webhooks)

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

## Permasalahan menarik

- [Kesalahan dan kode status](https://flashdata.dev/id/docs/errors/reference.md#status-codes)
- [Kapan untuk mencoba lagi](https://flashdata.dev/id/docs/errors/reference.md#retries)

## Terkait APIs

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