Explorar documentación
Primeros pasos
Usa las API de Google Search y YouTube directamente por HTTP. Envía una solicitud y lee la respuesta JSON, sin instalar un SDK.
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_KEYConfigurar la clave# PowerShell 7: paste the key into a hidden prompt. $flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString $env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password Remove-Variable flashdataSecureKeyHaz 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 / cURLcurl --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 } }'PowerShell 7+ · Pega y ejecuta este comando nativo de PowerShell.
Búsqueda · PowerShell$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataSearch = @{ Uri = 'https://data.flashdata.dev/v1/queries/realtime' Method = 'Post' Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } ContentType = 'application/json' Body = $flashdataRequest TimeoutSec = 70 MaximumRedirection = 0 SkipHttpErrorCheck = $true ErrorAction = 'Stop' } $flashdataResponse = Invoke-WebRequest @flashdataSearch $flashdataResponse.Content if ($flashdataResponse.StatusCode -ge 400) { throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying." }Node.js 22+ · Guarda el código como search.mjs en el directorio actual y ejecútalo localmente o en tu servidor. Usa fetch, incluido en Node.js; no necesitas instalar paquetes con npm.
search.mjsconst key = process.env.FLASHDATA_API_KEY; if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal."); let response; try { response = await fetch("https://data.flashdata.dev/v1/queries/realtime", { method: "POST", redirect: "error", signal: AbortSignal.timeout(70000), headers: { "X-API-Key": key, "Content-Type": "application/json" }, body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}), }); } catch { throw new Error("Request did not complete. Check History before resubmitting."); } const body = await response.text(); console.log(body); // Print the full response before checking its status. if (!response.ok) { const retryAfter = response.headers.get("retry-after"); throw new Error("HTTP " + response.status + ". See the response above." + (retryAfter ? " Retry-After: " + retryAfter : "")); } let result; try { result = JSON.parse(body); } catch { throw new Error("Expected JSON. Inspect the response above and the API URL."); } if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) { throw new Error("Query did not succeed. Inspect status and error in the response above."); }Ejecutar · JavaScriptnode search.mjsPython 3.10+ · Guarda el código como search.py en el directorio actual. Solo usa la biblioteca estándar; no necesitas instalar paquetes con pip. Sustituye python por python3 o py -3 si así ejecutas Python en tu equipo.
search.pyimport json import os import urllib.error import urllib.request key = os.environ.get("FLASHDATA_API_KEY") if not key: raise SystemExit("Set FLASHDATA_API_KEY in this terminal.") # Do not forward the API key to a redirect destination. class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request( "https://data.flashdata.dev/v1/queries/realtime", data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"), headers={"X-API-Key": key, "Content-Type": "application/json"}, method="POST", ) try: with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response: body = response.read().decode("utf-8") except urllib.error.HTTPError as error: print(error.read().decode("utf-8", errors="replace")) retry_after = error.headers.get("Retry-After") raise SystemExit("HTTP " + str(error.code) + ". See the response above." + (" Retry-After: " + retry_after if retry_after else "")) except (urllib.error.URLError, TimeoutError): raise SystemExit("Request did not complete. Check History before resubmitting.") print(body) # The run command saves this full response to result.json. try: result = json.loads(body) except json.JSONDecodeError: raise SystemExit("Expected JSON. Inspect the response above and the API URL.") if (not isinstance(result, dict) or result.get("error") is True or result.get("status") != "done" or not isinstance(result.get("results"), list)): raise SystemExit("Query did not succeed. Inspect status and error in the response above.")Ejecutar · Pythonpython -X utf8 search.pyComprueba 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.
--dump-header response-headers.txt --output result.jsonComprueba 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.
(
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
)try {
foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
Write-Host $flashdataPath
$flashdataRead = @{
Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
TimeoutSec = 20
MaximumRedirection = 0
ErrorAction = 'Stop'
}
Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
}
} catch {
throw
}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.