Sfoglia la documentazione
Per iniziare
Esegui la tua prima ricerca Google e ottieni risultati strutturati per la tua applicazione o il tuo agente IA.
Inizia con il tuo agente AI
Passa queste istruzioni a un agente con accesso al terminale. Configura FlashData ed esegue una ricerca.
Leggi https://flashdata.dev/auth.md e segui le istruzioni di configurazione di FlashData per questo ambiente. Riutilizza l’accesso esistente; se non è disponibile, avvia una sola prova se ne hai i requisiti. Cerca su Google "battery recycling research" con un massimo di cinque risultati. Restituisci i titoli delle fonti, le URL e i crediti effettivamente utilizzati. Conserva le credenziali in un archivio protetto, mai nella chat. Se l’accesso è bloccato, indica il passo successivo invece di creare un’altra prova.
Fai la tua prima chiamata API
Preferisci scrivere il codice? Segui questi tre passaggi nel terminale.
Ottieni una chiave API
Crea un account, verifica l’e-mail e crea una chiave con il permesso Google Search. Se hai già una chiave, riutilizzala.
Esegui il comando nel terminale e incolla la chiave nel campo nascosto. Salta questo passaggio se FLASHDATA_API_KEY è già impostata.
Imposta la chiave# 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_KEYImposta la chiave# 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 flashdataSecureKeyEsegui una ricerca
Scegli il linguaggio ed esegui l’esempio nello stesso terminale. Ogni esecuzione invia una ricerca.
Python 3.10+ · Salvare l'esempio come quickstart.py.
Installapython -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))Eseguipython quickstart.pyNode.js 22.18+ · Avviare in una cartella vuota e salvare quickstart.mts.
Configuranpm 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));Eseguinode quickstart.mtsNode.js 22+ · Avviare in una cartella vuota e salvare quickstart.mjs.
Configuranpm 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));Eseguinode quickstart.mjsGo 1.25+ · Parti da una cartella vuota e salva main.go. In un modulo esistente, salta go mod init.
Configurago 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) } }Eseguigo run .Non è necessario SDK. Eseguire sia il comando Bash / cURL 7.76+ che il comando 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 20Verifica il risultato
Una risposta riuscita contiene status: done. Trovi le fonti in results[].organic e i crediti addebitati in usage.credits.
Esempio di risposta (abbreviato){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Prova la console
- Crea un account o accedi. Verifica e-mail completa e qualsiasi configurazione dell'account mostrata nella console.
- Apri Google Search, seleziona la fonte Google Search e la modalità Realtime, poi inserisci battery recycling research. Espandi Additional parameters e imposta Page size (num) su 5.
- Controllare la richiesta visualizzata e i crediti disponibili, quindi eseguire la ricerca una volta.
- Ispezionare la risposta e l'uso. Aprire una fonte restituita per controllare il suo contenuto prima di citare più del suo estratto.
Continua dal tuo primo risultato
Se la prima richiesta fallisce
- Manca FLASHDATA_API_KEY
- Impostare la chiave nello stesso terminale o runtime dell'esempio; i file .env non sono caricati da questi frammenti.
- 401 / 403
- Controllare che la chiave o la connessione sia attiva e abbia il permesso google_search.
- 402
- Controlla i crediti disponibili in Billing. Collega la prova esistente a un account quando serve l’accesso del titolare.
- 429
- Rispetta Retry-After. Conserva la stessa identità e la stessa prova di registrazione; non avviare un’altra prova.
- Timeout o presentazione sconosciuta
- Controlla l’esecuzione esistente prima di riprovare. Con la CLI, mantieni lo stesso profilo e ID di esecuzione; con SDK/API, conserva ogni ID di operazione o richiesta restituito.