Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

API quickstart

Hubungi Google Search dan YouTube APIs secara langsung di atas HTTP. Kirim satu permintaan dan baca respon JSON; tidak diperlukan SDK.

  1. 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_KEY
  2. Jalankan 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 / 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. Periksa 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.

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

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

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