Semak dokumentasi
Mula di sini
Niapolis Call Google Search dan YouTube API langsung melalui HTTP. Kemudia mengirim satu permintaan dan membaca respon JSON; tidak ada SDK yang diperlukan.
Autentifikasi
Buat akun, periksa email Anda dan buat kunci dengan izin Google Search. Anda dapat menggunakan kembali kunci yang ada.
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
Ifinder memilih klien dan menjalankan contoh di terminal yang sama. Tiap-tiapnya mengirimkan satu permintaan POSTQ ke https://data.flashdata.dev/v1/queries/realtime dan mencetak JSON. Otentikasi dengan X-API-Key; kirim JSON dengan Content-Type: application/json.
cURL 7.76+ · Bash Pada Linux, macOS OR atau ORANG Git Bash. Kita pergi 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+ · Tempel perintah PowerShell asli ini.
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 22· Simpan sebagai search.mjs Anda dan lari ke lokal atau ke server Anda. Guna pengambilan bawaan; tidak ada pemasangan npm.
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.10+ · Simpan sebagai search.py. Hanya menggunakan perpustakaan standar; tidak ada pemasangan pip. Anda menggunakan 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.pySemak hasil
Konfirmasi keberhasilan HTTP dan status: done. Type, link dan snippet dalam results[].organic, dan muatan dalam usage.credits.
Hasil kosong atau daftar organik dengan status: done adalah hasil kosong yang valid.
Contoh respons{ "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" konfirmasi bahwa pertanyaan tersebut berhasil diselesaikan.
results[0].organic[]- Hasil pencarian mayat. Periksa bahwa hasil tidak kosong sebelum mengindeksnya.
title / link / snippet- Gelar Sumber, URL dan kutipan.
usage.credits- Kredit aktual yang dibebankan untuk pertanyaan ini.
Simpan respon untuk debug
Untuk menangkap permintaan selanjutnya, tambahkan pilihan ini ke perintah cURL di atas. Periksa berkas sebelum memutuskan untuk mencoba kembali permintaan yang gagal.
--dump-header response-headers.txt --output result.jsonPeriksa akses akses dan kredit
Kekhalifahan GET ini meminta untuk membaca identitas, keseimbangan dan pricing tanpa menggunakan kredit kueri. Expect HTTP 200 dan periksa bidang-bidang di bawah ini sebelum menyerahkan pekerjaan berbayar.
Akun baca: https://api.flashdata.dev/v2. Permintaan data permintaan bantuan: https://data.flashdata.dev/v1. Keduanya menggunakan X-API-Key; Permintaan JSON POST 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- Kepastian accountId, access: "ready", skop berisi "google_search", dan expiresAt. accountType adalah "owned" untuk kunci pemilik atau "temporary" untuk kunci percobaan.
balance- Baca availableCredits. Semua kunci untuk akun ini menggunakan keseimbangan yang sama.
pricing- Untuk harga yudien[0], konfirmasi sumber adalah google_search dan tersedia adalah true. Bandingkan estimatedCredits untuk requestCount: 1 dengan availableCredits. Harga dan keseimbangan dapat berubah sebelum penyerahan.
Langkah - langkah selanjutnya
Jika langkah gagal
Bacalah tanggapan yang dicetak di terminal Anda. JavaScript dan Python melaporkan kesalahan HTTP dan Retry-After ke stderr. Setiap contoh satu kali tunduk; ia tidak secara otomatis mencoba kembali.
- Perintah command hilang atau pilihan tidak didukung
- Semak versi yang diperlukan dalam contoh pilihan. Gunakan PowerShell 7, bukannya Windows PowerShell 5.1, atau gunakan Bash dengan cURL 7.76+. JavaScript memerlukan Node 22+; Python memerlukan 3.10+. Pasang runtime yang belum tersedia daripada halaman muat turun rasminya, buka semula terminal dan tetapkan kunci sekali lagi.
- Kunci hilang / 401
- Diagonia Set FLASHDATA_API_KEY dalam proses ini dan memeriksa identitas lagi. Bekalkan kunci API aktif penuh, tanpa awalan Bearer. Jika sudah kadaluarsa atau dicabut, gunakan kredensial yang sah saat ini; jangan tampal ke dalam chat.
- 403
- Periksa identity.scopes untuk google_search dan akses untuk siap. Meminta izin yang hilang dari pemilik; mengubah sumber dalam permintaan tidak memberikan akses.
- 402
- Baca keseimbangan lagi dan bandingkan dengan harga saat ini. owner dapat meninjau Billing. Pencobaan yang kelelahan membutuhkan akses pemilik melalui klaim; menciptakan pengadilan pengganti bukanlah pemulihan.
- 400 / 422
- Baca pesan kesalahan yang dikembalikan. Periksa host data yang tepat, metode POST, Content-Type dan JSON. Gunakan kutipan lurus dan params.num numerik, kemudian benar permintaan yang ditolak.
- 429
- Ospect Retry-After jika hadir; jika tidak gunakan backoff terikat dan mengurangi konkurensi. Jangan berputar cepat, membuat kunci baru atau mendaftarkan uji coba lain untuk melewati batas.
- HTTP 200 gagal pada status atau error
- Dia membaca kesalahan dalam tubuh dan menjaga setiap permintaan atau pekerjaan ID. Jangan perlakukan badan JSON yang terurai sebagai tugas yang sukses atau secara otomatis mengirimkannya kembali.
- Hasil Kosong
- Jika status sudah selesai, pengesahan berhasil. Simpan hasil kosong atau coba pertanyaan lebih luas sebagai permintaan berbayar baru.
- Masa habis, hilang sambungan, 5xx atau HTML daripada JSON
- A POST mungkin telah diterima bahkan jika responnya hilang. Cek History untuk pertanyaan asli dan jaga semua IDs yang dikembalikan sebelum memutuskan untuk mengirim kembali. Pemeriksaan GET gratis dapat dicoba ulang. Kepastian URL menggunakan data.flashdata.dev, bukan host situs web, dan tidak lumpuhkan verifikasi TLS.