# FlashData YouTube Suggestions API

YouTube automatisch aanvullen suggesties voor een trefwoord of zin, met taal en regio controles.

Canonische referentie: https://flashdata.dev/nl/docs/sources/youtube_suggestions
Beoordeeld: 2026-10-23

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

Vereiste brontoestemming: youtube_suggestions

Vervang YOUR_API_KEY door een API sleutel met deze bronmachtiging en beschikbare credits. Verzoeken uitvoeren op uw server of agent host.

[Authenticatie instellen](https://flashdata.dev/nl/docs/guides/headers-and-authentication/reference.md)

[Suggesties omzetten in een zoekopdracht](https://flashdata.dev/nl/docs/guides/youtube-data-guide/reference.md#suggestions)

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

## Een verzoek versturen

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

## Parameters

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

### Aanvraaginhoud

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Instellen op youtube_suggestions.  |
| <a id="parameter-query"></a> query | string | Ja | Niet ingesteld | Zoek voorvoegsel. Min lengte: 1. Maximale lengte: 2000. |
| <a id="parameter-params"></a> params | object | Nee | {} | Settings voor dit verzoek.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nee | Niet ingesteld | Async en alleen batch. Publieke HTTPS voltooiing URL op poort 443, tot 2,048 tekens. Geen gebruikersgegevens of URL-fragment. Gebruik null of een lege tekenreeks zonder melding. In een batch, zet dit op elke query, buiten params.  |

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

### Taalgebied

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-language"></a> params.language | string | Nee | "en" | Taalcode. Min lengte: 1. Maximale lengte: 35. Patroon: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-region"></a> params.region | string | Nee | "US" | Tweeletterige landcode, zoals VS, GB of DE. Min lengte: 2. Maximale lengte: 2. Patroon: ^[A-Za-z]{2}$ |

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

## Lees het resultaat

Bewaar de succesvolle JSON respons als response.json. Sla dit op als read-response.py en voer python read-response.py uit. Het gebruikt alleen de standaardbibliotheek van Python en doet geen nieuw verzoek.

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

## Voorbeeldantwoord

Opgenomen voorbeeld; velden en tellingen zijn afhankelijk van de bron en de gevraagde invoer.
```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"
}
```

## Responsvelden

| Veld | Type | Omschrijving |
| --- | --- | --- |
| source | string | De gevraagde API bron. |
| status | string | gedaan wanneer het real-time verzoek slaagt. |
| created_at | string | Aanmaaktijd voor respons in ISO 8601-formaat. |
| usage.credits | number | Credits in rekening gebracht voor het verzoek, op basis van uw plan. |
| results[0] | array<string> | Stelt u zelf voorstellen in. Elke array-invoer is een voorgestelde zoekzin. |

- Een lege array betekent dat er geen suggesties werden teruggestuurd voor het meegeleverde voorvoegsel.

## Antwoordformaten

Antwoorden gebruiken JSON standaard. Kies een ander formaat met deze optionele headers.

- Accept: application/json (standaard) of text/plain. Platte tekst geeft dezelfde velden weer in een leesbare, ingespringde lay-out.
- X-Respond-With: markdown. Laat uitgevallen voor originele velden. Markdown werkt met beide responsformaten.

Markdown is beschikbaar voor real-time queries en voltooide resultaten.

De velden hieronder beschrijven de standaard JSON response.

[Voorbeelden van verzoeken en antwoorden](https://flashdata.dev/nl/docs/guides/response-formats/reference.md#headers)

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

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

## API-basisprincipes

De aanvraagbouwer en voorbeelden hierboven gebruiken de parameters van deze bron. Gebruik hieronder de voorbeelden Python en cURL voor gedeelde inzending, status en resultaatstappen. Een Batch body is een JSON object met queries; elk item geeft zijn eigen job ID terug.

- [Async verzoek en ontvangst](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async)

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

- [Taakstatus controleren](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#status)

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

- [Gereedgemaakte resultaten ophalen](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON verzoeken](https://flashdata.dev/nl/docs/reference/batch-and-bulk/reference.md#batch)
- [Klant OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Aanmeldingen tot voltooiing

- [Ontvang en verifieer complete webhooks](https://flashdata.dev/nl/docs/guides/async-batch/reference.md#webhooks)

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

## Problemen oplossen

- [Fouten en statuscodes](https://flashdata.dev/nl/docs/errors/reference.md#status-codes)
- [Wanneer opnieuw proberen](https://flashdata.dev/nl/docs/errors/reference.md#retries)

## Gerelateerde API's

- [YouTube Search API](https://flashdata.dev/nl/docs/sources/youtube_search/reference.md)
- [YouTube Uitgebreide zoekopdracht API](https://flashdata.dev/nl/docs/sources/youtube_search_extended/reference.md)
