Jelajahi dokumentasi
Mulai
Jalankan pencarian Google pertama dan dapatkan hasil terstruktur untuk aplikasi atau agen AI Anda.
Mulai dengan agen AI Anda
Berikan prompt ini kepada agen yang memiliki akses terminal. Agen akan menyiapkan FlashData dan menjalankan satu pencarian.
Baca https://flashdata.dev/auth.md dan ikuti petunjuk penyiapan FlashData untuk lingkungan ini. Gunakan kembali akses yang ada; jika tidak ada, mulai satu uji coba hanya jika memenuhi syarat. Cari "battery recycling research" di Google dengan maksimal lima hasil. Kembalikan judul sumber, URL, dan kredit yang benar-benar digunakan. Simpan kredensial dalam penyimpanan terlindungi, bukan di chat. Jika akses diblokir, laporkan langkah berikutnya alih-alih membuat uji coba baru.
Lakukan panggilan API pertama
Ingin menulis kodenya sendiri? Ikuti tiga langkah ini di terminal.
Dapatkan API key
Buat akun, verifikasi email, lalu buat key dengan izin Google Search. Jika sudah memiliki key, gunakan kembali.
Jalankan di terminal dan tempel key pada prompt yang menyembunyikan input. Lewati langkah ini jika FLASHDATA_API_KEY sudah diatur.
Atur key 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_KEYAtur key 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 pencarian
Pilih bahasa pemrograman dan jalankan contoh di terminal yang sama. Setiap eksekusi mengirim satu pencarian.
Python 3.10+ · Simpan contoh sebagai quickstart.py.
Instalpython -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+ · Mulai dari folder kosong dan simpan quickstart.mts.
Siapkannpm 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+ · Mulai dari folder kosong dan simpan quickstart.mjs.
Siapkannpm 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+ · Mulai dari folder kosong dan simpan main.go. Lewati go mod init jika menggunakan modul yang sudah ada.
Siapkango 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 .Tidak memerlukan SDK. Jalankan perintah Bash / cURL 7.76+ atau 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 20Periksa hasil
Respons yang berhasil memiliki status: done. Sumber ada di results[].organic, sedangkan kredit yang dikenakan ada di usage.credits.
Contoh respons (disingkat){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Coba konsol
- Buat akun atau masuk. Selesaikan verifikasi email dan penyiapan akun yang ditampilkan di konsol.
- Buka Google Search, pilih sumber Google Search dan mode Realtime, lalu masukkan battery recycling research. Buka Additional parameters dan atur Page size (num) menjadi 5.
- Periksa permintaan yang ditampilkan dan kredit yang tersedia, lalu jalankan pencarian sekali.
- Periksa respons dan penggunaan. Buka sumber yang dikembalikan untuk memeriksa isinya sebelum mengutip lebih dari cuplikannya.
Lanjutkan dari hasil pertama
Jika permintaan pertama gagal
- FLASHDATA_API_KEY belum diatur
- Atur key di terminal atau runtime yang sama dengan contoh. Cuplikan ini tidak memuat file .env.
- 401 / 403
- Pastikan key atau koneksi aktif dan memiliki izin google_search.
- 402
- Periksa kredit yang tersedia di Billing. Tautkan uji coba yang sudah ada jika memerlukan akses pemilik.
- 429
- Patuhi Retry-After. Pertahankan identitas dan bukti pendaftaran yang sama; jangan membuat uji coba lain.
- Timeout atau status pengiriman tidak diketahui
- Periksa eksekusi yang ada sebelum mencoba lagi. Pengguna CLI harus mempertahankan profil dan ID eksekusi yang sama; pengguna SDK/API harus menyimpan ID tugas atau permintaan yang dikembalikan.