# FlashData YouTube Trainability API

Überprüfen Sie die Lizenzmetadaten eines YouTube-Videos auf ein Creative Commons-Label und rufen Sie das Ergebnis als JSON ab.

Kanonische Referenz: https://flashdata.dev/de/docs/sources/youtube_trainability
Überarbeitet: 2026-10-23

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

Erforderliche Berechtigung für die Quelle: youtube_trainability

Ersetzen Sie YOUR_API_KEY durch einen API-Schlüssel, der über diese Quellberechtigung und verfügbare Credits verfügt. Führen Sie Anfragen auf Ihrem Server oder Agent-Host aus.

[Authentifizierung einrichten](https://flashdata.dev/de/docs/guides/headers-and-authentication/reference.md)

[Interpretieren von Lizenzlabels](https://flashdata.dev/de/docs/guides/youtube-data-guide/reference.md#license)

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

## Senden Sie eine Anfrage

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

## Parameter

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

### Anfrageinhalt

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Setzen Sie auf youtube_trainability.  |
| <a id="parameter-video_id"></a> video_id | string | Ja | Nicht eingestellt | Das 11-Charakter YouTube Video ID, wie FUfGcZ092b0. Akzeptiert Buchstaben, Zahlen, Unterstriche und Bindestriche. Min. Länge: 11. Maximale Länge: 11. Muster: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nein | Nicht eingestellt | Async und Batch nur. Öffentliche HTTPS Fertigstellung URL auf Port 443, bis zu 2,048 Zeichen. Keine Benutzeranmeldeinformationen oder URL-Fragment. Verwenden Sie null oder einen leeren String für keine Benachrichtigung. Setzen Sie dies in einem Batch auf jede Abfrage, außerhalb von Params.  |

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

## Lesen Sie das Ergebnis

Speichern Sie die erfolgreiche JSON-Antwort als response.json. Speichern Sie dies als read-response.py und führen Sie Python read-response.py aus. Es verwendet nur die Standardbibliothek von Python und stellt keine neue Anforderung.

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

## Beispielantwort

Aufgezeichnetes Beispiel; Felder und Zählungen hängen von der Quelle und der angeforderten Eingabe ab.
```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"
}
```

## Antwortfelder

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| source | string | Die angeforderte API-Quelle. |
| status | string | Dies geschieht, wenn die Echtzeitanforderung erfolgreich ist. |
| created_at | string | Antworterstellungszeit im Format ISO 8601. |
| usage.credits | number | Credits, die für die anfrage berechnet werden, basierend auf ihrem plan. |
| results[0].videoId | string | Das angeforderte Video ID. |
| results[0].kind | string | FlashData Ergebnistyp: youtube#videoTrainability. |
| results[0].etag | string | Video ID wurde als Antwort-Tag wiederholt. |
| results[0].permitted | array<string> | ["all"], wenn ein Creative Commons-Label erkannt wird; andernfalls ["none"], auch wenn Lizenzmetadaten fehlen. Diese Werte melden nicht die YouTube-Schulungseinstellungen von Drittanbietern des Erstellers. |

- Dieser Endpunkt liest Videolizenz-Metadaten. Es ruft keine YouTube-Schulungsberechtigungen von Drittanbietern ab und keiner der beiden Werte gewährt die Berechtigung zum Trainieren auf dem Video.

## Antwortformate

Antworten verwenden standardmäßig JSON. Wählen Sie ein anderes Format mit diesen optionalen Headern.

- Accept: application/json (Ausfall) oder text/plain. Klartext präsentiert die gleichen Felder in einem lesbaren, eingerückten Layout.
- X-Respond-With: markdown. Lassen Sie unset für Originalfelder. Markdown funktioniert mit beiden Antwortformaten.

Markdown steht für Echtzeit-Abfragen und abgeschlossene Ergebnisse zur Verfügung.

Die folgenden Felder beschreiben die Standardantwort von JSON.

[Beispiele für das Anforderungs- und Antwortformat](https://flashdata.dev/de/docs/guides/response-formats/reference.md#headers)

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

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

## API-Grundlagen

Der Request Builder und die obigen Beispiele verwenden die Parameter dieser Quelle. Verwenden Sie die Beispiele Python und cURL unten für gemeinsame Eingabe-, Status- und Ergebnisschritte. Ein Batch-Body ist ein JSON-Objekt, das Abfragen enthält; jedes Element gibt seinen eigenen Job ID zurück.

- [Async Anfrage und Empfang](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#async)

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

- [Jobstatus überprüfen](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#status)

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

- [Abrufen abgeschlossener Ergebnisse](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON Anfragen](https://flashdata.dev/de/docs/reference/batch-and-bulk/reference.md#batch)
- [API für Bulk-Verarbeitung](https://flashdata.dev/de/docs/reference/bulk-processing/reference.md)
- [Erstellen Sie einen Bulk-Workflow für diese Quelle](https://flashdata.dev/de/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [Kunden-OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Abschlussmeldungen

- [Empfangen und Verifizieren von Abschluss-Webhooks](https://flashdata.dev/de/docs/guides/async-batch/reference.md#webhooks)

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

## Fehlerbehebung

- [Fehler und Statuscodes](https://flashdata.dev/de/docs/errors/reference.md#status-codes)
- [Wann man es erneut versucht](https://flashdata.dev/de/docs/errors/reference.md#retries)

## Verwandte APIs

- [YouTube Video Metadaten API](https://flashdata.dev/de/docs/sources/youtube_metadata/reference.md)
- [YouTube Download API](https://flashdata.dev/de/docs/sources/youtube_download/reference.md)
