Saltar al contenido
ES
Obtener clave API
Explorar documentación

Referencia de la API

Formatos de respuesta

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.

RespuestaAcceptX-Respond-WithUso para
JSONapplication/jsonOmitCampos de par en código · predeterminado
JSON + Markdownapplication/jsonmarkdownContexto de agente con metadatos estructurados
Texto de la traduccióntext/plainOmitLeyendo campos originales en una terminal
Texto + Markdowntext/plainmarkdownLeer 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.

Solicitud · cURL / Bash
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"}'
Respuesta de ejemplo · Valores ilustrativos
{
  "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"
}

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 finalJSON / texto planoContenido de Markdown
POST /v1/queries/realtimeApoyoApoyo
GET /v2/jobs/{id}/resultsApoyoApoyo
POST /v1/queriesSubmission receiptIgnorado — seleccione cuando lee resultados
POST /v1/queries/batchSubmission receiptIgnorado — seleccione cuando lee resultados
GET /v2/jobs/{id}Condición laboralIgnorado: 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 solicitadoRespuesta a los resultados
Original JSON302 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 Markdown200 con el cuerpo formateado directamente en la respuesta.
Retrieve Markdown inside JSON · cURL / Bash
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ódigoArreglos
400 · unsupported_representationUtilice X-Respond-With: marcador o omitir el encabezado. Los valores como json o texto no son compatibles.
406 · not_acceptableUse 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.

Texto preferido, permite JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8