Documentatie bekijken
Aan de slag
Voer je eerste Google-zoekopdracht uit en ontvang gestructureerde resultaten voor je app of AI-agent.
Begin met je AI-agent
Geef deze prompt aan een agent met terminaltoegang. Die stelt FlashData in en voert één zoekopdracht uit.
Lees https://flashdata.dev/auth.md en volg de FlashData-installatie-instructies voor deze omgeving. Hergebruik bestaande toegang; start alleen als die ontbreekt één proefperiode als je daarvoor in aanmerking komt. Zoek op Google naar "battery recycling research" met maximaal vijf resultaten. Geef de brontitels, URL’s en daadwerkelijk gebruikte credits terug. Bewaar inloggegevens in beveiligde opslag, nooit in de chat. Meld bij geblokkeerde toegang de volgende stap in plaats van een nieuwe proefperiode aan te maken.
Je eerste API-aanroep uitvoeren
Schrijf je liever zelf de code? Volg deze drie stappen in je terminal.
Een API-sleutel aanmaken
Maak een account, verifieer je e-mailadres en maak een sleutel met Google Search-toestemming. Heb je al een sleutel? Gebruik die hier.
Voer dit uit in je terminal en plak je sleutel in de verborgen invoer. Sla deze stap over als FLASHDATA_API_KEY al is ingesteld.
Je sleutel instellen# 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_KEYJe sleutel instellen# 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 flashdataSecureKeyEen zoekopdracht uitvoeren
Kies je programmeertaal en voer het voorbeeld uit in dezelfde terminal. Elke uitvoering verzendt één zoekopdracht.
Python 3.10+ · Sla het voorbeeld op als quickstart.py.
Installerenpython -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))Uitvoerenpython quickstart.pyNode.js 22.18+ · Begin in een lege map en sla quickstart.mts op.
Instellennpm 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));Uitvoerennode quickstart.mtsNode.js 22+ · Begin in een lege map en sla quickstart.mjs op.
Instellennpm 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));Uitvoerennode quickstart.mjsGo 1.25+ · Begin in een lege map en sla main.go op. Sla go mod init over in een bestaande module.
Instellengo 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) } }Uitvoerengo run .Geen SDK nodig. Voer de opdracht voor Bash / cURL 7.76+ of voor PowerShell 7 uit.
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 20Het resultaat controleren
Een geslaagd antwoord bevat status: done. Bronnen staan in results[].organic en het verbruik in usage.credits.
Voorbeeldantwoord (ingekort){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
De console proberen
- Maak een account of log in. Verifieer je e-mailadres en voltooi de accountinstellingen die de console toont.
- Open Google Search, kies de bron Google Search en de modus Realtime en voer battery recycling research in. Open Additional parameters en stel Page size (num) in op 5.
- Controleer de getoonde aanvraag en je beschikbare credits. Voer de zoekopdracht daarna één keer uit.
- Bekijk het antwoord en het verbruik. Open een teruggegeven bron om de inhoud te controleren voordat je meer citeert dan het fragment.
Verder bouwen op je eerste resultaat
Als de eerste aanvraag mislukt
- FLASHDATA_API_KEY ontbreekt
- Stel de sleutel in dezelfde terminal of runtime in als het voorbeeld. Deze fragmenten laden geen .env-bestanden.
- 401 / 403
- Controleer of de sleutel of verbinding actief is en google_search-toestemming heeft.
- 402
- Controleer je beschikbare credits in Billing. Koppel een bestaande proefperiode als toegang van de eigenaar nodig is.
- 429
- Volg Retry-After. Behoud dezelfde identiteit en hetzelfde registratiebewijs; maak geen nieuwe proefperiode aan.
- Timeout of onduidelijke verzendstatus
- Controleer de bestaande uitvoering voordat je opnieuw probeert. CLI-gebruikers behouden hetzelfde profiel en dezelfde uitvoerings-ID; SDK/API-gebruikers bewaren elke teruggegeven taak- of aanvraag-ID.