Parcourir la documentation
Premiers pas
Lancez votre première recherche Google et obtenez des résultats structurés pour votre application ou votre agent IA.
Commencez avec votre agent IA
Transmettez ces instructions à un agent disposant d’un terminal. Il configurera FlashData et effectuera une recherche.
Lisez https://flashdata.dev/auth.md et suivez les instructions de configuration de FlashData pour cet environnement. Réutilisez les accès existants ; à défaut, démarrez un seul essai si vous y êtes admissible. Recherchez "battery recycling research" sur Google et demandez au plus cinq résultats. Renvoyez les titres, les URL et les crédits réellement consommés. Conservez les identifiants dans un stockage protégé, jamais dans la conversation. Si l’accès est bloqué, indiquez l’étape suivante au lieu de créer un autre essai.
Effectuez votre premier appel API
Vous préférez écrire le code ? Suivez ces trois étapes dans votre terminal.
Obtenez une clé API
Créez un compte, vérifiez votre adresse e-mail et créez une clé autorisant Google Search. Si vous disposez déjà d’une clé, réutilisez-la.
Exécutez cette commande dans votre terminal et collez la clé dans la saisie masquée. Ignorez cette étape si FLASHDATA_API_KEY est déjà définie.
Définir votre clé# 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_KEYDéfinir votre clé# 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 flashdataSecureKeyLancer une recherche
Choisissez votre langage et exécutez l’exemple dans le même terminal. Chaque exécution effectue une recherche.
Python 3.10+ · Enregistrez l’exemple dans quickstart.py.
Installerpython -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))Exécuterpython quickstart.pyNode.js 22.18+ · Partez d’un dossier vide et enregistrez quickstart.mts.
Configurernpm 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));Exécuternode quickstart.mtsNode.js 22+ · Partez d’un dossier vide et enregistrez quickstart.mjs.
Configurernpm 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));Exécuternode quickstart.mjsGo 1.25+ · Partez d’un dossier vide et enregistrez main.go. Dans un module existant, omettez go mod init.
Configurergo 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) } }Exécutergo run .Aucun SDK nécessaire. Exécutez la commande Bash / cURL 7.76+ ou la commande 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 20Vérifiez le résultat
Une réponse réussie contient status: done. Les sources se trouvent dans results[].organic et les crédits facturés dans usage.credits.
Exemple de réponse (extrait){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Essayez la console
- Créez un compte ou connectez-vous. Vérifiez votre adresse e-mail et terminez les étapes de configuration affichées dans la console.
- Ouvrez Google Search, sélectionnez la source Google Search et le mode Realtime, puis saisissez battery recycling research. Développez Additional parameters et définissez Page size (num) sur 5.
- Vérifiez la requête affichée et les crédits disponibles, puis lancez la recherche une seule fois.
- Examinez la réponse et la consommation. Ouvrez une source renvoyée pour en vérifier le contenu avant de citer davantage que son extrait.
Allez plus loin
Si la première requête échoue
- FLASHDATA_API_KEY manquante
- Définissez la clé dans le terminal ou l’environnement qui exécute l’exemple ; ces extraits ne chargent pas les fichiers .env.
- 401 / 403
- Vérifiez que la clé ou la connexion est active et dispose de l’autorisation google_search.
- 402
- Vérifiez les crédits disponibles dans Billing. Rattachez l’essai existant si un accès titulaire est nécessaire.
- 429
- Respectez Retry-After. Conservez la même identité et la même preuve d’inscription ; ne créez pas un autre essai.
- Délai dépassé ou résultat de soumission inconnu
- Vérifiez l’exécution existante avant de réessayer. Avec la CLI, conservez le profil et l’identifiant d’exécution ; avec un SDK ou l’API, conservez tout identifiant de tâche ou de requête reçu.