Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

Inicio rápido de la API

Usa las API de Google Search y YouTube directamente por HTTP. Envía una solicitud y lee la respuesta JSON, sin instalar un SDK.

  1. Configura la autenticación

    Crea una cuenta, verifica tu correo electrónico y crea una clave con permiso para Google Search. También puedes reutilizar una clave que ya tenga ese permiso.

    Ejecuta este bloque en la terminal y pega tu clave cuando se solicite; no se mostrará en pantalla. Omite este paso si FLASHDATA_API_KEY ya está definida.

    Configurar la clave
    # Bash: paste the key into a hidden prompt, not into this command.
    read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
    printf '\n'
    export FLASHDATA_API_KEY
  2. Haz una búsqueda

    Elige un cliente y ejecuta su ejemplo en la misma terminal. Cada ejemplo envía una solicitud POST a https://data.flashdata.dev/v1/queries/realtime y muestra la respuesta JSON. Usa X-API-Key para autenticarte y Content-Type: application/json para enviar JSON.

    cURL 7.76+ · Usa Bash en Linux, macOS o Git Bash en Windows. Pega el comando y ejecútalo.

    Búsqueda · Bash / cURL
    curl --fail-with-body --silent --show-error --max-time 70 \
      --request POST https://data.flashdata.dev/v1/queries/realtime \
      --header "X-API-Key: $FLASHDATA_API_KEY" \
      --header 'Content-Type: application/json' \
      --data '{
      "source": "google_search",
      "query": "battery recycling research",
      "params": {
        "num": 5
      }
    }'
  3. Comprueba el resultado

    Comprueba que la respuesta HTTP sea correcta y que el cuerpo indique status: done. Los títulos, enlaces y fragmentos están en results[].organic; el consumo de créditos está en usage.credits.

    Si results o la lista organic están vacíos y el estado es status: done, la consulta terminó correctamente, pero no encontró resultados.

    Ejemplo de respuesta
    {
      "source": "google_search",
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    El valor "done" confirma que la consulta terminó correctamente.
    results[0].organic[]
    Resultados de búsqueda. Comprueba que results contenga algún elemento antes de acceder a results[0].
    title / link / snippet
    Título, URL y fragmento de la fuente.
    usage.credits
    Créditos cobrados por esta consulta.

Guarda la respuesta para diagnosticar errores

Añade estas opciones al comando cURL anterior para guardar las cabeceras y el cuerpo de tu próxima solicitud. No son un comando independiente. Revisa los archivos antes de decidir si repites una solicitud fallida.

cURL
--dump-header response-headers.txt --output result.json

Comprueba el acceso y los créditos

Estas solicitudes GET consultan la identidad, el saldo y los precios sin consumir créditos de consulta. Comprueba que devuelvan HTTP 200 y revisa los campos siguientes antes de enviar una solicitud de pago.

Consultas de cuenta: https://api.flashdata.dev/v2. Solicitudes de datos: https://data.flashdata.dev/v1. Ambas usan X-API-Key; las solicitudes POST con JSON también requieren Content-Type: application/json.

Comprobaciones gratuitas · Bash
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
  printf '\n%s\n' "$endpoint"
  curl --fail-with-body --silent --show-error --max-time 20 \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --write-out '\nHTTP %{http_code}\n' \
    "https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)
identity
Confirma el accountId esperado, access: "ready" y que scopes incluya "google_search". Revisa expiresAt si aparece. accountType es "owned" para una clave de una cuenta del titular y "temporary" para una clave de prueba.
balance
Revisa availableCredits. Todas las claves de la cuenta comparten el mismo saldo.
pricing
En prices[0], comprueba que source sea google_search y available sea true. Compara estimatedCredits para requestCount: 1 con availableCredits. El precio y el saldo pueden cambiar antes de enviar la solicitud.

Siguientes pasos

Si un paso falla

Lee la respuesta en la terminal. Los ejemplos de JavaScript y Python muestran los errores HTTP y Retry-After en stderr. Cada ejemplo envía una sola solicitud, sin reintentos automáticos.

Comando no encontrado u opción no compatible
Comprueba la versión que requiere el ejemplo: PowerShell 7, no Windows PowerShell 5.1; Bash con cURL 7.76+; Node.js 22+ para JavaScript; o Python 3.10+. Instala la herramienta desde su página oficial, vuelve a abrir la terminal y configura de nuevo la clave.
Falta la clave / 401
Define FLASHDATA_API_KEY en este proceso y vuelve a consultar identity. Usa la clave API activa completa, sin el prefijo Bearer. Si ha caducado o se ha revocado, usa una credencial autorizada vigente. No pegues la clave en el chat.
403
Comprueba que identity.scopes incluya google_search y que access sea ready. Pide al titular el permiso que falta; cambiar source en la solicitud no concede acceso.
402
Vuelve a consultar el saldo y compáralo con el precio actual. El titular puede revisar Billing. Si la prueba se ha agotado, vincúlala a una cuenta y obtén acceso autorizado del titular. Crear otra prueba no resuelve el problema.
400 / 422
Lee el error devuelto. Revisa el dominio de la API de datos, el método POST, Content-Type y los nombres de los campos JSON. Usa comillas rectas y un valor numérico para params.num; después, corrige la solicitud rechazada.
429
Respeta Retry-After si aparece. Si no, aumenta la espera entre reintentos, limita su número y reduce la concurrencia. No reintentes en un bucle rápido ni crees claves o pruebas nuevas para eludir el límite.
HTTP 200, pero el cuerpo indica un fallo
Lee el error en el cuerpo y conserva los identificadores de la solicitud o del trabajo. Poder leer el JSON no significa que la tarea haya terminado correctamente. No repitas la solicitud automáticamente.
Resultados vacíos
Si status es done, la autenticación funcionó. Conserva el resultado vacío o prueba una búsqueda más amplia como una nueva solicitud de pago.
Tiempo de espera agotado, conexión perdida, 5xx o HTML en lugar de JSON
La solicitud POST puede haberse aceptado aunque se haya perdido la respuesta. Busca la consulta original en History y conserva los identificadores recibidos antes de decidir si la reenvías. Puedes reintentar las comprobaciones GET gratuitas. Confirma que la URL use data.flashdata.dev, no el dominio del sitio web, y mantén activada la verificación TLS.