Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Cepatstart cepat API

Niapolis Call Google Search dan YouTube API langsung melalui HTTP. Kemudia mengirim satu permintaan dan membaca respon JSON; tidak ada SDK yang diperlukan.

  1. 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_KEY
  2. Jalankan 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 / cURL
    curl --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
      }
    }'
  3. Semak 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.

cURL
--dump-header response-headers.txt --output result.json

Periksa 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.

Pemeriksaan gratis · Bash
(
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
)
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.