Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

Panduan cepat

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.

Lakukan panggilan API pertama

Ingin menulis kodenya sendiri? Ikuti tiga langkah ini di terminal.

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

    Pilih bahasa pemrograman dan jalankan contoh di terminal yang sama. Setiap eksekusi mengirim satu pencarian.

    Python 3.10+ · Simpan contoh sebagai quickstart.py.

    Instal
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import 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))
    Jalankan
    python quickstart.py
  3. Periksa 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

  1. Buat akun atau masuk. Selesaikan verifikasi email dan penyiapan akun yang ditampilkan di konsol.
  2. 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.
  3. Periksa permintaan yang ditampilkan dan kredit yang tersedia, lalu jalankan pencarian sekali.
  4. 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.