# Referencia de la API

Parámetros, esquemas de respuesta y ejemplos ejecutables para cada fuente.

Referencia canónica: https://flashdata.dev/es/docs/reference

<a id="request-basics"></a>

## Conceptos básicos de las solicitudes

Indica el producto en source y autentícate con X-API-Key. Las páginas de cada fuente incluyen los campos exactos, ejemplos de respuesta y un formulario interactivo para preparar solicitudes.

### Servidores de la API

```text
Data API        https://data.flashdata.dev
Management API  https://api.flashdata.dev
Header          X-API-Key: YOUR_API_KEY
```

| Flujo de trabajo | Solicitud | Devuelve |
| --- | --- | --- |
| Realtime · API de datos | POST /v1/queries/realtime | Resultados de la fuente en la respuesta |
| Async · API de datos | POST /v1/queries | Un identificador de trabajo para consultar el estado y los resultados |
| Batch · API de datos | POST /v1/queries/batch | Un recibo independiente por consulta |
| Bulk · Management API | POST /v2/bulk-jobs | Un identificador Bulk y una URL firmada para subir el archivo de entrada |
| Trabajo · API de gestión | GET /v2/jobs/{id} | El estado de un trabajo existente |

### [API](https://flashdata.dev/es/docs/guides/http-quickstart/reference.md)

¿Es tu primera vez con la API? Configura tu clave y ejecuta una primera solicitud completa.

<a id="api-basics"></a>

## Conceptos básicos de la API

### [Tiempo real y modo asíncrono](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md)

Recibe los resultados en la respuesta o envía un trabajo para recuperarlos después. Elige cómo espera tu aplicación o agente a que termine el trabajo.

### [Batch y Bulk](https://flashdata.dev/es/docs/reference/batch-and-bulk/reference.md)

Usa Batch para consultas independientes con entradas distintas. Usa Bulk para un archivo de identificadores de vídeo que requieran la misma operación.

### [Formatos de respuesta](https://flashdata.dev/es/docs/guides/response-formats/reference.md)

Elige JSON estructurado para tu aplicación o contenido Markdown para un agente de IA. Configura la respuesta con dos cabeceras.

### [Errores y códigos de estado](https://flashdata.dev/es/docs/errors/reference.md)

Interpreta una respuesta de error y decide si debes corregir la solicitud, reintentar o detenerte.

<a id="google-search"></a>

## Google Search

### [Búsqueda](https://flashdata.dev/es/docs/sources/google_search/reference.md)

Recuperar resultados orgánicos, preguntas relacionadas y resultados ricos de Google Buscar como JSON estructurado. Filtrar por país, idioma y ubicación.

source: `google_search`

### [Imágenes](https://flashdata.dev/es/docs/sources/google_images/reference.md)

Buscar Google Imágenes y recuperar la imagen original URLs, miniaturas, dimensiones y páginas de origen como JSON.

source: `google_images`

### [Noticias](https://flashdata.dev/es/docs/sources/google_news/reference.md)

Recuperar Google Noticias artículos con titulares, publicaciones de origen, enlaces y fechas de publicación. Filtrar por país, idioma y rango de fecha.

source: `google_news`

### [Compras](https://flashdata.dev/es/docs/sources/google_shopping/reference.md)

Buscar Google Compras para productos y recupera precios, comerciantes, valoraciones y enlaces de productos en JSON estructurado.

source: `google_shopping`

### [Vídeos](https://flashdata.dev/es/docs/sources/google_videos/reference.md)

Encuentra videos en sitios web con Google Videos. Recupera títulos, enlaces de vídeo, miniaturas, duración e información de origen.

source: `google_videos`

### [Lugares](https://flashdata.dev/es/docs/sources/google_places/reference.md)

Buscar negocios locales y lugares. Recuperar nombres, direcciones, coordenadas, calificaciones y datos de contacto cuando esté disponible.

source: `google_places`

<a id="youtube-data"></a>

## YouTube Data

### [Búsqueda](https://flashdata.dev/es/docs/sources/youtube_search/reference.md)

Buscar videos YouTube por palabra clave y recuperar títulos, canales, duración, cuenta de vista y miniaturas como JSON.

source: `youtube_search`

### [Búsqueda ampliada](https://flashdata.dev/es/docs/sources/youtube_search_extended/reference.md)

Recuperar hasta 700 YouTube resultados de búsqueda por solicitud, con detalles de vídeo, miniaturas y filtros de búsqueda.

source: `youtube_search_extended`

### [Metadatos de vídeo](https://flashdata.dev/es/docs/sources/youtube_metadata/reference.md)

Recuperar metadatos de vídeo por YouTube video ID, incluyendo detalles de canal, conteos de compromiso, miniaturas, formatos disponibles y capítulos.

source: `youtube_metadata`

### [Transcripción](https://flashdata.dev/es/docs/sources/youtube_transcript/reference.md)

Recuperar texto de transcripción YouTube con timetamps y una transcripción completa. Los títulos automáticos se seleccionan por defecto.

source: `youtube_transcript`

### [Subtítulos](https://flashdata.dev/es/docs/sources/youtube_captions/reference.md)

Recuperar las capciones YouTube como texto de timetamped y una transcripción completa. Las subscripciones proporcionadas por el cargador se seleccionan por defecto.

source: `youtube_captions`

### [Canal](https://flashdata.dev/es/docs/sources/youtube_channel/reference.md)

Recuperar un perfil de canal YouTube y sus videos recientes por mango, incluyendo conteos de suscriptores, imágenes de canal y detalles de vídeo.

source: `youtube_channel`

### [Sugerencias](https://flashdata.dev/es/docs/sources/youtube_suggestions/reference.md)

Retrieve YouTube autocomplete sugerencias para una palabra clave o frase, con controles de idioma y región.

source: `youtube_suggestions`

### [Etiquetas de licencia](https://flashdata.dev/es/docs/sources/youtube_trainability/reference.md)

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

source: `youtube_trainability`

<a id="youtube-download"></a>

## YouTube Download

### [Descarga](https://flashdata.dev/es/docs/sources/youtube_download/reference.md)

Descargar el vídeo YouTube o el audio a su almacenamiento en la nube. Elija la resolución, formato y duración del clip, luego siga el trabajo asincrónico a través de la terminación.

source: `youtube_download`

<a id="bulk-processing"></a>

## Procesamiento Bulk

### [API de procesamiento Bulk](https://flashdata.dev/es/docs/reference/bulk-processing/reference.md)

Crea y gestiona trabajos de YouTube a partir de archivos y recupera sus manifiestos y partes de resultados.

<a id="group-5"></a>

## Referencias de protocolos

### [API de gestión](https://flashdata.dev/es/docs/api-reference/reference.md)

Trabajos, acceso a cuentas, registro de agentes, vinculación y entrega de credenciales.

### [Herramientas y esquemas MCP](https://flashdata.dev/es/docs/mcp/reference.md)

Argumentos de herramientas, gestión de cuentas, trabajos en segundo plano y resultados de gran tamaño.

<a id="group-6"></a>

## Especificaciones y referencias de clientes

### [Especificación OpenAPI (JSON)](https://flashdata.dev/docs/openapi.json)

Operaciones y esquemas en un formato que pueden leer las herramientas de API.

### [Referencia de comandos de la CLI](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

Comandos, opciones y códigos de salida de la versión 1.2.1. Abre GitHub.

### [Referencia de métodos del SDK de Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

Métodos y tipos del cliente de la versión 1.1.0. Abre GitHub.
