# FlashData YouTube Suggestions API

Erişim tarihi: YouTube, bir anahtar kelime veya cümle için, dil ve bölge kontrolleri ile.

Canonical referans: https://flashdata.dev/tr/docs/sources/youtube_suggestions
İnceleme: 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Kimlik doğrulama: X-API-Key: YOUR_API_KEY
Modes Modes: [Realtime](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)

Gerekli kaynak izni izni: youtube_suggestions

Değişimi Değiştir YOUR_API_KEY Biriyle birlikte API Bu kaynak izni ve mevcut kredilere sahip anahtar. sunucunuzda veya acente ev sahibinizde yükleme talepleri.

[Varsayılan kimlik doğrulamayı ayarlayın](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)

[Bir aramaya önerileri girin](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md#suggestions)

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

## Bir istek gönder

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

## Parametreler

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

### İstek gövdesi

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Evet Evet Evet | — | youtube_suggestions'a ayarlayın.  |
| <a id="parameter-query"></a> query | string | Evet Evet Evet | Set Not set Not set | Arama eki. Min uzunluğu: 1. Max uzunluğu: 2000. |
| <a id="parameter-params"></a> params | object | Hayır yok hayır | {} | Settings bu istek için.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Hayır yok hayır | Set Not set Not set | Async ve sadece toplu. Halk Halk Halkı HTTPS Tamam tamamlanma tamamlanma tamamlanma tamamlandı URL limanda 443, yukarı 2,048 karakterler. Kullanıcı Bilgileri veya URL parçaları yok. Omit, null veya bildirim için boş bir dize kullanın. Bir partide, bunu her sorguda, params dışında ayarlayın.  |

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

### Dil & Bölge

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string | Hayır yok hayır | "en" | Dil kodu. Min uzunluğu: 1. Max uzunluğu: 35. Desen: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-region"></a> params.region | string | Hayır yok hayır | "US" | ABD, GB veya DE gibi iki harfli ülke kodu. Min uzunluğu: 2. Max uzunluğu: 2. Desen: ^[A-Za-z]{2}$ |

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

## Sonuç okuyun

JSON yanıtını response.json olarak kurtarın. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Sadece Python'un standart kütüphanesini kullanır ve yeni bir istek yapmaz.

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

## Örnek yanıt

Kayıt örneği; alanlar ve sayılar kaynağına bağlıdır ve talep edilen girdiye bağlıdır.
```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"
}
```

## Yanıt alanları

| Field | Tür Türü Tipi | Description Description Description |
| --- | --- | --- |
| source | string | Talep edilen API kaynağı. |
| status | string | Gerçek zamanlı istek başarılı olduğunda yapılır. |
| created_at | string | ISO 8601 formatındaki arama süresi. |
| usage.credits | number | Krediler talep için ücretlendirilir, planınıza göre. |
| results[0] | array<string> | Autocomplete önerileri. Her dizi girişi önerilen bir arama cümlesidir. |

- Boş bir dizi, sunulan ön ek için önerilerin iade edilmediği anlamına gelir.

## Yanıt biçimleri

Yanıtlar JSON'u varsayılan olarak kullanır. Bu opsiyonel başlıkları ile başka bir format seçin.

- Accept: application/json (varsayılan) veya veya veya text/plain. Plain text aynı alanları okunabilir, okunabilir bir düzende sunar.
- X-Respond-With: markdown. Orijinal alanlarda başlangıç bırakın. Markdown, yanıt formatı ile çalışır.

Markdown gerçek zamanlı sorgular ve tamamlanmış sonuçlar için mevcuttur.

Aşağıdaki alanlar varsayılan JSON yanıtını tanımlar.

[İstek ve yanıt formatı örnekleri](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#headers)

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

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

## API temelleri

Yukarıdaki istek oluşturucu ve örnekler bu kaynağın parametrelerini kullanır. Python ve cURL örneklerini paylaşılan teslimiyet, durum ve sonuç adımları için kullanın. Bir Batch vücut, sorgu içeren bir JSON nesnedir; her öğe kendi işini döndürür ID.

- [Async isteği ve makbuz](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async)

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

- [Check job status](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#status)

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

- [Erişim tamamlanmış sonuçlar](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON talep ediyor](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)
- [Müşteri Açık API](https://flashdata.dev/docs/openapi.json)

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

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

## Tamamlanan bildirimleri tamamlayın

- [Satın alın ve doğrulama webhooks](https://flashdata.dev/tr/docs/guides/async-batch/reference.md#webhooks)

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

## Sorun Giderme

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md#status-codes)
- [Yeniden deneme ne zaman](https://flashdata.dev/tr/docs/errors/reference.md#retries)

## İlgili APIs

- [YouTube Search API](https://flashdata.dev/tr/docs/sources/youtube_search/reference.md)
- [YouTube Genişletilmiş Arama API](https://flashdata.dev/tr/docs/sources/youtube_search_extended/reference.md)
