# FlashData YouTube Trainability API

Controleer de licentiemetadata van een YouTube-video voor een Creative Commons-label en haal het resultaat op als JSON.

Canonische referentie: https://flashdata.dev/nl/docs/sources/youtube_trainability
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) · [Bulk](https://flashdata.dev/nl/docs/reference/bulk-processing/reference.md)

Vereiste brontoestemming: youtube_trainability

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)

[Licentielabels interpreteren](https://flashdata.dev/nl/docs/guides/youtube-data-guide/reference.md#license)

<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_trainability",
    "video_id": "dQw4w9WgXcQ",
}

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_trainability",
  "video_id": "dQw4w9WgXcQ"
}
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_trainability.  |
| <a id="parameter-video_id"></a> video_id | string | Ja | Niet ingesteld | De 11-karakter YouTube video ID, zoals FUfGcZ092b0. Accepteert letters, cijfers, onderstrepingen en koppeltekens. Min lengte: 11. Maximale lengte: 11. Patroon: ^[A-Za-z0-9_-]{11}$ |
| <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="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 = {"videoId": result.get("videoId"), "permitted": result.get("permitted", [])}
# Keep the label values; this is not a training-rights authorization.
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_trainability",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "kind": "youtube#videoTrainability",
      "etag": "dQw4w9WgXcQ",
      "permitted": [
        "none"
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:45:48.691Z"
}
```

## 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].videoId | string | De gevraagde video ID. |
| results[0].kind | string | FlashData resultaattype: youtube#videoTrainability. |
| results[0].etag | string | Video ID echoed als de response tag. |
| results[0].permitted | array<string> | ["all"] wanneer een Creative Commons-label wordt gedetecteerd; anders ["none"], ook wanneer licentiemetadata ontbreken. Deze waarden rapporteren niet de YouTube trainingsinstellingen van de maker. |

- Dit eindpunt leest videolicentie metadata. Het haalt YouTube trainingsmachtigingen van derden niet op en geen van beide geeft toestemming om te trainen op de video.

## 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)
- [API voor Bulk-verwerking](https://flashdata.dev/nl/docs/reference/bulk-processing/reference.md)
- [Bouw een Bulk workflow voor deze bron](https://flashdata.dev/nl/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [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 Video Metadata API](https://flashdata.dev/nl/docs/sources/youtube_metadata/reference.md)
- [YouTube Download API](https://flashdata.dev/nl/docs/sources/youtube_download/reference.md)
