Explorar documentación
Referencia de la API
Elige JSON estructurado para tu aplicación o contenido Markdown para un agente de IA. Configura la respuesta con dos cabeceras.
En esta página
Elija un formato
JSON con campos de resultado originales es el valor predeterminado. Accept selecciona JSON o texto plano; X-Respond-With: markdown convierte el contenido de resultado a Markdown. Su cuerpo de solicitud permanece JSON.
| Respuesta | Accept | X-Respond-With | Uso para |
|---|---|---|---|
| JSON | application/json | Omit | Campos de par en código · predeterminado |
| JSON + Markdown | application/json | markdown | Contexto de agente con metadatos estructurados |
| Texto de la traducción | text/plain | Omit | Leyendo campos originales en una terminal |
| Texto + Markdown | text/plain | markdown | Leer metadatos y Markdown juntos |
Ejemplos de solicitud y respuesta
Estas pestañas muestran el mismo Google Buscar en cada formato. Utilice Bash y cURL 7.76+ con FLASHDATA_API_KEY configurado a una clave que permite google_search. Ejecutar un comando envía una búsqueda facturable.
Default. Parse el array de resultados; los campos dentro de él dependen de la fuente.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"results": [
{
"organic": [
{
"title": "Example page",
"link": "https://example.com/article",
"snippet": "A short source snippet."
}
]
}
],
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z"
}Lea el contenido como una cadena Markdown. Reemplaza los resultados; fuente, estado y uso permanecen disponibles como campos JSON.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z",
"content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}Lea la respuesta como texto. Contiene los campos originales en un diseño identificado, no un documento JSON.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Results:
1:
Organic:
1:
Title: "Example page"
Link: "https://example.com/article"
Snippet: "A short source snippet."
Usage:
Credits: 0.01
Created at: "2026-10-22T12:00:00.000Z"
Lea la respuesta como texto: metadatos primero, seguido por el contenido Markdown.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"
Markdown Content:
# Google search
## Organic
### 1. Example page
**Link:** <https://example.com/article>
**Snippet:** A short source snippet\.
Puntos finales compatibles
Las mismas reglas se aplican a las fuentes de búsqueda Google y YouTube. Para YouTube Download, formatean el registro de entrega, no los bytes de vídeo o audio. APIs de cuenta, manifiestos Bulk y partes NDJSON, callbacks y respuestas MCP usan sus propios formatos.
| Punto final | JSON / texto plano | Contenido de Markdown |
|---|---|---|
| POST /v1/queries/realtime | Apoyo | Apoyo |
| GET /v2/jobs/{id}/results | Apoyo | Apoyo |
| POST /v1/queries | Submission receipt | Ignorado — seleccione cuando lee resultados |
| POST /v1/queries/batch | Submission receipt | Ignorado — seleccione cuando lee resultados |
| GET /v2/jobs/{id} | Condición laboral | Ignorado: sin contenido de resultados aquí |
Formato del resultado del trabajo completado
Establece los encabezados al leer el resultado, incluso si los establece en la presentación. Establece JOB_ID a un trabajo completado que puede acceder. Este GET lee los resultados existentes sin enviar otra consulta.
| Formato solicitado | Respuesta a los resultados |
|---|---|
| Original JSON | 302 con un almacenamiento firmado URL en Ubicación. Tome que URL por separado, sin X-API-Key. Los resultados almacenados pueden ser gzip-compressed. |
| Texto de la línea o la opción Markdown | 200 con el cuerpo formateado directamente en la respuesta. |
curl --fail-with-body --silent --show-error \
"https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Accept: application/json' \
--header 'X-Respond-With: markdown'Errores de formato
Los errores de la API siguen en formato JSON o application/problem+json aunque solicites texto plano. Comprueba el estado HTTP antes de interpretar el formato de éxito.
| Estado / código | Arreglos |
|---|---|
| 400 · unsupported_representation | Utilice X-Respond-With: marcador o omitir el encabezado. Los valores como json o texto no son compatibles. |
| 406 · not_acceptable | Use Accept: application/json o text/plain. text/markdown y application/xml no son compatibles. |
Accept header details
Omit Accept o enviar */* para obtener JSON. Las respuestas utilizan UTF-8. Se admiten rangos de medios y pesos q; un charset no soportado devuelve 406 a menos que otro rango aceptable coincida. Content-Type: application/json describe el cuerpo de solicitud, no la respuesta.
Accept: text/plain; charset=utf-8, application/json;q=0.8