# FlashData YouTube Trainability API

Compruebe un metadato de licencia de YouTube para una etiqueta Creative Commons y recuperar el resultado como JSON.

Referencia canónica: https://flashdata.dev/es/docs/sources/youtube_trainability
Reviewed: 2026-10-23

Punto final: POST https://data.flashdata.dev/v1/queries/realtime
Autenticación: X-API-Key: YOUR_API_KEY
Modos: [Tiempo real](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#realtime) · [Asíncrono](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/es/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/es/docs/reference/bulk-processing/reference.md)

Permiso de origen obligatorio: youtube_trainability

Reemplace YOUR_API_KEY con una tecla API que tiene este permiso de origen y créditos disponibles. Ejecute solicitudes en su servidor o host de agente.

[Configuración de autenticación](https://flashdata.dev/es/docs/guides/headers-and-authentication/reference.md)

[Interpretar etiquetas de licencia](https://flashdata.dev/es/docs/guides/youtube-data-guide/reference.md#license)

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

## Enviar solicitud

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

## Parámetros

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

### Solicitud de cuerpo

| Parámetro | Tipo | Obligatorio | Default | Descripción |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Sí. | — | Listo para youtube_trainability.  |
| <a id="parameter-video_id"></a> video_id | string | Sí. | Sin definir | El 11-character YouTube video ID, como FUfGcZ092b0. Acepta letras, números, subrayados e hifénes. Longitud mínima: 11. Longitud máxima: 11. Patrón: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | No. | Sin definir | Solo Async y lote. Public HTTPS completion URL en port 443, hasta caracteres 2,048. No hay credenciales de usuario o fragmento URL. Omitir, usar null o una cadena vacía para ninguna notificación. En un lote, establece esto en cada consulta, fuera de los params.  |

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

## Lea el resultado

Guardar la respuesta JSON exitosa como response.json. Guardar esto como read-response.py y ejecutar python read-response.py. Utiliza sólo la biblioteca estándar de Python y no hace ninguna nueva petición.

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

## Ejemplo de respuesta

Ejemplo registrado; campos y conteos dependen de la fuente y la entrada solicitada.
```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"
}
```

## Campos de respuesta

| Campo | Tipo | Descripción |
| --- | --- | --- |
| source | string | La fuente API solicitada. |
| status | string | hecho cuando la solicitud en tiempo real tiene éxito. |
| created_at | string | Tiempo de creación de respuestas en formato ISO 8601. |
| usage.credits | number | Créditos cobrados para la solicitud, basado en su plan. |
| results[0].videoId | string | El vídeo solicitado ID. |
| results[0].kind | string | FlashData tipo de resultado: youtube#videoTrainability. |
| results[0].etag | string | Video ID se hizo eco como la etiqueta de respuesta. |
| results[0].permitted | array<string> | ["all"] cuando se detecta una etiqueta Creative Commons; de lo contrario ["none"], incluso cuando faltan los metadatos de licencia. Estos valores no reportan los ajustes de entrenamiento de terceros del creador YouTube. |

- Este punto final lee metadatos de licencia de vídeo. No recupera permisos de formación de terceros YouTube, y tampoco otorga permiso de valor para entrenar en el vídeo.

## Formatos de respuesta

Las respuestas utilizan JSON por defecto. Elige otro formato con estos encabezados opcionales.

- Accept: application/json (por defecto) o text/plain. El texto sencillo presenta los mismos campos en un diseño legible e indentado.
- X-Respond-With: markdown. Deja unset para campos originales. Markdown funciona con formato de respuesta.

Markdown está disponible para consultas en tiempo real y resultados completados.

Los campos de abajo describen la respuesta JSON predeterminada.

[Ejemplos de formularios de solicitud y respuesta](https://flashdata.dev/es/docs/guides/response-formats/reference.md#headers)

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

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

## Conceptos básicos de la API

El constructor de solicitudes y los ejemplos anteriores utilizan los parámetros de esta fuente. Use los ejemplos Python y cURL a continuación para la presentación compartida, estado y pasos de resultado. Un cuerpo Batch es un objeto JSON que contiene consultas; cada artículo devuelve su propio trabajo ID.

- [Solicitud y recepción de Async](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#async)

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

- [Consultar el estado del trabajo](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#status)

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

- [Recuperar los resultados](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON peticiones](https://flashdata.dev/es/docs/reference/batch-and-bulk/reference.md#batch)
- [API de procesamiento Bulk](https://flashdata.dev/es/docs/reference/bulk-processing/reference.md)
- [Construir un flujo de trabajo Bulk para esta fuente](https://flashdata.dev/es/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [Cliente OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Notificaciones de terminación

- [Recibir y verificar los juegos web de terminación](https://flashdata.dev/es/docs/guides/async-batch/reference.md#webhooks)

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

## Solución de problemas

- [Errores y códigos de estado](https://flashdata.dev/es/docs/errors/reference.md#status-codes)
- [Cuándo volver a entrar](https://flashdata.dev/es/docs/errors/reference.md#retries)

## API relacionadas

- [YouTube Metadatos de vídeo API](https://flashdata.dev/es/docs/sources/youtube_metadata/reference.md)
- [YouTube Descargar API](https://flashdata.dev/es/docs/sources/youtube_download/reference.md)
