# FlashData YouTube Suggestions API

Retrievee YouTube saran autocomplete untuk kata kunci atau frasa, dengan bahasa dan kontrol wilayah.

Referensi boonical: https://flashdata.dev/ms/docs/sources/youtube_suggestions
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_suggestions

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)

[Saran - saran yang dilakukan untuk mencari](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#suggestions)

<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_suggestions",
    "query": "python",
    "params": {
        "language": "en",
        "region": "us",
    },
}

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_suggestions",
  "query": "python",
  "params": {
    "language": "en",
    "region": "us"
  }
}
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_suggestions.  |
| <a id="parameter-query"></a> query | string | Ya | Tidak Diset | Awalan pencarian. Panjang Min: 1. Panjang maksimum: 2000. |
| <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>

### Bahasa Mandarin & wilayah

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string | Tak ada | "en" | Kod bahasa. Panjang Min: 1. Panjang maksimum: 35. Corak: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-region"></a> params.region | string | Tak ada | "US" | Kode negara dua huruf, seperti US, GB atau DE. Panjang Min: 2. Panjang maksimum: 2. Corak: ^[A-Za-z]{2}$ |

<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 = result  # An array of phrases, including an empty array.
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_suggestions",
  "status": "done",
  "results": [
    [
      "python for beginners",
      "python hunting everglades",
      "python",
      "python full course",
      "python funk",
      "python got7",
      "python commands",
      "python cowboy",
      "python tutorial",
      "python projects",
      "python coding",
      "python course",
      "python snake",
      "python basics"
    ]
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:41:47.147Z"
}
```

## 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] | array<string> | Saran-saran Autocomplete. Setiap entri array adalah sebuah frasa pencarian yang disarankan. |

- Sebuah susunan kosong berarti tidak ada saran yang dikembalikan untuk awalan yang diberikan.

## 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 Search API](https://flashdata.dev/ms/docs/sources/youtube_search/reference.md)
- [YouTube Lanjutan Pencarian API](https://flashdata.dev/ms/docs/sources/youtube_search_extended/reference.md)
