Semak dokumentasi
Mula di sini
Jalankan carian Google pertama anda dan dapatkan hasil berstruktur untuk aplikasi atau ejen AI anda.
Mulakan dengan ejen AI anda
Berikan prom ini kepada ejen yang mempunyai akses terminal. Ejen akan menyediakan FlashData dan menjalankan satu carian.
Baca https://flashdata.dev/auth.md dan ikuti arahan persediaan FlashData untuk persekitaran ini. Gunakan semula akses sedia ada; jika tiada, mulakan satu percubaan sahaja jika layak. Cari "battery recycling research" di Google dengan maksimum lima hasil. Kembalikan tajuk sumber, URL dan kredit yang benar-benar digunakan. Simpan bukti kelayakan dalam storan yang dilindungi, bukan dalam sembang. Jika akses disekat, nyatakan langkah seterusnya dan jangan buat percubaan baharu.
Buat panggilan API pertama anda
Mahu menulis kod sendiri? Ikuti tiga langkah ini dalam terminal.
Dapatkan kunci API
Cipta akaun, sahkan e-mel anda dan cipta kunci dengan kebenaran Google Search. Gunakan semula kunci sedia ada jika anda sudah memilikinya.
Jalankan dalam terminal dan tampal kunci apabila diminta; input akan disembunyikan. Langkau jika FLASHDATA_API_KEY sudah ditetapkan.
Tetapkan kunci anda# 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_KEYTetapkan kunci anda# 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 flashdataSecureKeyJalankan carian
Pilih bahasa pengaturcaraan dan jalankan contoh dalam terminal yang sama. Setiap pelaksanaan menghantar satu carian.
Python 3.10+ · Simpan contoh sebagai quickstart.py.
Pasangpython -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))Jalankanpython quickstart.pyNode.js 22.18+ · Mulakan dalam folder kosong dan simpan quickstart.mts.
Sediakannpm 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));Jalankannode quickstart.mtsNode.js 22+ · Mulakan dalam folder kosong dan simpan quickstart.mjs.
Sediakannpm 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));Jalankannode quickstart.mjsGo 1.25+ · Mulakan dalam folder kosong dan simpan main.go. Langkau go mod init dalam modul sedia ada.
Sediakango 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) } }Jalankango run .SDK tidak diperlukan. Jalankan arahan Bash / cURL 7.76+ atau arahan 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 20Semak hasil
Respons yang berjaya mempunyai status: done. Sumber berada dalam results[].organic dan kredit yang digunakan dalam usage.credits.
Contoh respons (diringkaskan){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Cuba konsol
- Cipta akaun atau log masuk. Lengkapkan pengesahan e-mel dan sebarang persediaan akaun yang dipaparkan dalam konsol.
- Buka Google Search, pilih sumber Google Search dan mod Realtime, kemudian masukkan battery recycling research. Kembangkan Additional parameters dan tetapkan Page size (num) kepada 5.
- Semak permintaan yang dipaparkan dan kredit yang tersedia, kemudian jalankan carian sekali.
- Semak respons dan penggunaan. Buka sumber yang dikembalikan untuk menyemak kandungannya sebelum memetik maklumat di luar petikannya.
Teruskan daripada hasil pertama anda
Jika permintaan pertama gagal
- FLASHDATA_API_KEY tiada
- Tetapkan kunci dalam terminal atau runtime yang sama dengan contoh. Petikan kod ini tidak memuatkan fail .env.
- 401 / 403
- Pastikan kunci atau sambungan aktif dan mempunyai kebenaran google_search.
- 402
- Semak kredit yang tersedia dalam Billing. Pautkan percubaan sedia ada kepada akaun jika anda memerlukan akses pemilik.
- 429
- Ikuti Retry-After. Kekalkan identiti dan bukti pendaftaran yang sama; jangan cipta percubaan lain.
- Tamat masa atau status penyerahan tidak diketahui
- Semak pelaksanaan sedia ada sebelum mencuba lagi. Pengguna CLI perlu mengekalkan profil dan ID pelaksanaan yang sama; pengguna SDK/API perlu menyimpan ID tugas atau permintaan yang diterima.