Jelajahi dokumentasi
Mulai
Hubungi Google Search dan YouTube APIs secara langsung di atas HTTP. Kirim satu permintaan dan baca respon JSON; tidak diperlukan SDK.
Otentikasi
Buat akun, verifikasi surel Anda dan buat kunci dengan izin Google Search. Anda dapat menggunakan kembali kunci yang telah ada.
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 klien dan jalankan contoh di terminal yang sama. Masing-masing mengirimkan satu POST permintaan untuk https://data.flashdata.dev/v1/queries/realtime dan cetakan JSON. Authentikasi dengan X-API-Key; kirim JSON dengan Content-Type: application/json.
cURL 7.76+ · Bash nyala Linux, macOS atau Git Bash. Tempel dan lari.
Cari Bash / cURLcurl --fail-with-body --silent --show-error --max-time 70 \ --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 + ini adalah perintah asli PowerShell.
Cari PowerShell$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataSearch = @{ Uri = 'https://data.flashdata.dev/v1/queries/realtime' Method = 'Post' Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } ContentType = 'application/json' Body = $flashdataRequest TimeoutSec = 70 MaximumRedirection = 0 SkipHttpErrorCheck = $true ErrorAction = 'Stop' } $flashdataResponse = Invoke-WebRequest @flashdataSearch $flashdataResponse.Content if ($flashdataResponse.StatusCode -ge 400) { throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying." }Node.js 22Simpan sebagai search.mjs dan menjalankan lokal atau pada server Anda. Penggunaan built-in fetch; tidak ada npm install.
search.mjsconst key = process.env.FLASHDATA_API_KEY; if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal."); let response; try { response = await fetch("https://data.flashdata.dev/v1/queries/realtime", { method: "POST", redirect: "error", signal: AbortSignal.timeout(70000), headers: { "X-API-Key": key, "Content-Type": "application/json" }, body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}), }); } catch { throw new Error("Request did not complete. Check History before resubmitting."); } const body = await response.text(); console.log(body); // Print the full response before checking its status. if (!response.ok) { const retryAfter = response.headers.get("retry-after"); throw new Error("HTTP " + response.status + ". See the response above." + (retryAfter ? " Retry-After: " + retryAfter : "")); } let result; try { result = JSON.parse(body); } catch { throw new Error("Expected JSON. Inspect the response above and the API URL."); } if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) { throw new Error("Query did not succeed. Inspect status and error in the response above."); }Jalankan JavaScriptnode search.mjsPython 3.10Simpan sebagai search.py. Gunakan hanya perpustakaan standar; tidak ada instalasi pip. Gunakan python3 atau py -3 jika itu adalah perintah Python Anda.
search.pyimport json import os import urllib.error import urllib.request key = os.environ.get("FLASHDATA_API_KEY") if not key: raise SystemExit("Set FLASHDATA_API_KEY in this terminal.") # Do not forward the API key to a redirect destination. class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request( "https://data.flashdata.dev/v1/queries/realtime", data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"), headers={"X-API-Key": key, "Content-Type": "application/json"}, method="POST", ) try: with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response: body = response.read().decode("utf-8") except urllib.error.HTTPError as error: print(error.read().decode("utf-8", errors="replace")) retry_after = error.headers.get("Retry-After") raise SystemExit("HTTP " + str(error.code) + ". See the response above." + (" Retry-After: " + retry_after if retry_after else "")) except (urllib.error.URLError, TimeoutError): raise SystemExit("Request did not complete. Check History before resubmitting.") print(body) # The run command saves this full response to result.json. try: result = json.loads(body) except json.JSONDecodeError: raise SystemExit("Expected JSON. Inspect the response above and the API URL.") if (not isinstance(result, dict) or result.get("error") is True or result.get("status") != "done" or not isinstance(result.get("results"), list)): raise SystemExit("Query did not succeed. Inspect status and error in the response above.")Jalankan Pythonpython -X utf8 search.pyPeriksa hasil
Konfirmasi keberhasilan HTTP dan status: done. Baca judul sumber, links dan snippet dalam results[].organic, dan muatan dalam usage.credits.
Hasil kosong atau daftar organik dengan status: done adalah hasil kosong yang valid.
Respon contoh{ "source": "google_search", "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- "done" mengkonfirmasi query telah selesai dengan sukses.
results[0].organic[]- Hasil pencarian. Periksa hasil yang tidak kosong sebelum mengindeksinya.
title / link / snippet- Judul sumber, URL dan excerpt.
usage.credits- Kredit Actual charged for this query.
Simpan respon untuk debug
Untuk mengambil permintaan selanjutnya, tambahkan opsi ini ke perintah cURL di atas. Inspeksi berkas sebelum memutuskan untuk mencoba ulang permintaan yang gagal.
--dump-header response-headers.txt --output result.jsonPeriksa akses dan kredit
Ini permintaan GET membaca identitas, keseimbangan dan harga tanpa menggunakan kredit query. Diharapkan HTTP 200 dan memeriksa bidang di bawah ini sebelum mengirimkan pekerjaan yang dibayar.
Akun berbunyi: https://api.flashdata.dev/v2. Permintaan data: https://data.flashdata.dev/v1. Keduanya menggunakan X-API-Key; JSON POST permintaan juga menggunakan Content-Type: application/json.
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
printf '\n%s\n' "$endpoint"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--write-out '\nHTTP %{http_code}\n' \
"https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)try {
foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
Write-Host $flashdataPath
$flashdataRead = @{
Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
TimeoutSec = 20
MaximumRedirection = 0
ErrorAction = 'Stop'
}
Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
}
} catch {
throw
}identity- Konfirmasikan yang dimaksudkan accountId, access: "ready", scopes berisi "google_search", dan apapun expiresAt. accountType adalah "owned" untuk kunci pemilik atau "temporary" untuk kunci percobaan.
balance- Baca availableCredits. Semua kunci untuk akun ini memakai keseimbangan yang sama.
pricing- Untuk harga [0], konfirmasi sumber adalah google_search dan tersedia adalah true. Bandingkan estimatedCredits untuk requestCount: 1 dengan availableCredits. Harga dan keseimbangan bisa berubah sebelum penyerahan.
Langkah selanjutnya
Jika satu langkah gagal
Baca respon yang dicetak di terminal Anda. JavaScript dan Python melaporkan kesalahan HTTP dan Retry-After ke stderr. Setiap contoh menyerah sekali, tidak secara otomatis mencoba kembali.
- Perintah hilang atau pilihan tidak didukung
- Periksa versi yang diperlukan dalam contoh yang dipilih. Gunakan PowerShell 7 daripada Windows PowerShell 5.1, atau gunakan Bash dengan cURL 7.76+. JavaScript membutuhkan Node 22 +; Python kebutuhan 3.10+. Pasang waktu jalan yang hilang dari halaman pengunduhan resminya, buka kembali terminal, lalu atur lagi kuncinya.
- Kehilangan kunci / 401
- Atur FLASHDATA_API_KEY dalam proses ini dan periksa identitas lagi. Menyediakan kunci API yang aktif secara penuh, tanpa awalan Pemula. Bila kadaluarsa atau dicabut, gunakan kredensial resmi saat ini; jangan tempelkan ke percakapan.
- 403
- Periksa identity.scopes untuk google_search dan akses untuk siap. Permintaan izin yang hilang dari pemilik; mengubah sumber dalam permintaan tidak memberikan akses.
- 402
- Baca saldo lagi dan bandingkan dengan harga saat ini. Pemilik dapat meninjau Billing. Sebuah percobaan yang melelahkan membutuhkan akses pemilik melalui klaim; menciptakan percobaan pengganti bukanlah pemulihan.
- 400 / 422
- Baca pesan galat yang dikembalikan. Periksa host data yang tepat, metoda POST, Content-Type dan nama field JSON. Gunakan kutipan lurus dan numerik params.num, lalu perbaiki permintaan ditolak.
- 429
- Menghormati Retry-After jika ada saat ini; sebaliknya gunakan sebuah baunded backoff dan kurangi konkuensi. Jangan loop dengan cepat, buat kunci baru atau daftar percobaan lain untuk melewati batas.
- HTTP 200 dengan status atau error gagal
- Baca kesalahan dalam tubuh dan melestarikan permintaan atau pekerjaan ID. Jangan perlakukan tubuh JSON yang diurai sebagai tugas yang sukses atau secara otomatis mengirimkannya kembali.
- Hasil kosong
- Jika status selesai, otentikasi bekerja. Simpan hasil kosong atau coba query lebih luas sebagai permintaan baru yang dibayar.
- Tenggat waktu, kehilangan koneksi, 5xx atau HTML bukan JSON
- Sebuah POST mungkin telah diterima bahkan jika respon telah hilang. Periksa History untuk query asli dan jaga kembali IDs sebelum memutuskan untuk mengirim kembali. Cek GET gratis dapat dicoba kembali. Konfirmasikan URL menggunakan data.flashdata.dev, bukan host website, dan jangan menonaktifkan verifikasi TLS.