Explorar documentación
Primeros pasos
Haz tu primera búsqueda en Google y obtén resultados estructurados para tu aplicación o agente de IA.
Empieza con tu agente de IA
Envía estas instrucciones a un agente con acceso al terminal. Configurará FlashData y hará una búsqueda.
Lee https://flashdata.dev/auth.md y sigue las instrucciones de configuración de FlashData para este entorno. Reutiliza el acceso existente; si no existe, inicia una sola prueba si cumples los requisitos. Busca en Google "battery recycling research" y devuelve hasta cinco resultados. Incluye los títulos, las URLs y los créditos realmente consumidos. Guarda las credenciales en un almacén protegido, nunca en el chat. Si el acceso está bloqueado, indica el siguiente paso en lugar de crear otra prueba.
Haz tu primera llamada a la API
¿Prefieres escribir el código? Sigue estos tres pasos en tu terminal.
Obtén una clave API
Crea una cuenta, verifica tu correo y crea una clave con permiso de Google Search. Si ya tienes una clave con ese permiso, reutilízala.
Ejecuta este comando en el terminal y pega la clave cuando se solicite; no se mostrará en pantalla. Omite este paso si FLASHDATA_API_KEY ya está definida.
Configura tu 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_KEYConfigura tu 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 lenguaje y ejecuta el ejemplo en el mismo terminal. Cada ejecución hace una búsqueda.
Python 3.10+ · Guarda el ejemplo como quickstart.py.
Instalarpython -m pip install "flashdata==1.1.0"quickstart.pyimport json import os from flashdata import FlashData with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client: response = client.google.search("battery recycling research", num=5) if response["status"] != "done": raise RuntimeError(response) print(json.dumps(response, indent=2))Ejecutarpython quickstart.pyNode.js 22.18+ · Empieza en una carpeta vacía y guarda el archivo quickstart.mts.
Preparar el proyectonpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mtsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Ejecutarnode quickstart.mtsNode.js 22+ · Empieza en una carpeta vacía y guarda el archivo quickstart.mjs.
Preparar el proyectonpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mjsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Ejecutarnode quickstart.mjsGo 1.25+ · Empieza en una carpeta vacía y guarda el archivo main.go. Omite go mod init si ya estás en un módulo existente.
Preparar el proyectogo mod init example.com/flashdata-quickstart go get github.com/flashdatadev/[email protected]main.gopackage main import ( "context" "encoding/json" "log" "os" "time" flashdata "github.com/flashdatadev/flashdata-go" ) func main() { key := os.Getenv("FLASHDATA_API_KEY") if key == "" { log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.") } client, err := flashdata.New(flashdata.Options{APIKey: key}) if err != nil { log.Fatal(err) } ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) defer cancel() result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{ Query: "battery recycling research", Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))}, }) if err != nil { // Do not automatically resubmit an uncertain paid request. log.Fatal(err) } if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { log.Fatal(err) } if result.Status != "done" { log.Fatalf("Search did not complete: %s", result.Status) } }Ejecutargo run .No necesitas un SDK. Ejecuta el comando de Bash / cURL 7.76+ o el de PowerShell 7.
Bash / cURLcurl --fail-with-body --silent --show-error \ --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$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest $flashdataResult | ConvertTo-Json -Depth 20Comprueba el resultado
Una respuesta correcta contiene status: done. Las fuentes están en results[].organic y los créditos cobrados, en usage.credits.
Ejemplo de respuesta abreviado{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Prueba la consola
- Crea una cuenta o inicia sesión. Verifica tu correo y completa la configuración que indique la consola.
- Abre Google Search, selecciona la fuente Google Search y el modo Realtime, e introduce battery recycling research. Despliega Additional parameters y establece Page size (num) en 5.
- Comprueba la solicitud y los créditos disponibles antes de ejecutar la búsqueda una vez.
- Revisa la respuesta y el consumo. Abre una de las fuentes para comprobar su contenido antes de citar información que no aparezca en el fragmento devuelto.
Sigue a partir de tu primer resultado
Si falla la primera solicitud
- Falta FLASHDATA_API_KEY
- Define la clave en el mismo terminal o entorno que ejecuta el ejemplo. Estos fragmentos no cargan archivos .env automáticamente.
- 401 / 403
- Comprueba que la clave o conexión esté activa y tenga el permiso google_search.
- 402
- Consulta los créditos disponibles en Billing. Vincula una prueba existente cuando necesites acceso como titular de una cuenta.
- 429
- Respeta Retry-After. Conserva la misma identidad y prueba de registro; no crees otra prueba.
- Tiempo de espera agotado o envío sin confirmar
- Comprueba la ejecución existente antes de reintentar. En la CLI, conserva el perfil y el identificador de ejecución. Con el SDK o la API, guarda cualquier identificador de trabajo o de solicitud recibido.