Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Mula pantas

Jalankan carian Google pertama anda dan dapatkan hasil berstruktur untuk aplikasi atau ejen AI anda.

Mulakan dengan ejen AI anda

Berikan prom ini kepada ejen yang mempunyai akses terminal. Ejen akan menyediakan FlashData dan menjalankan satu carian.

Buat panggilan API pertama anda

Mahu menulis kod sendiri? Ikuti tiga langkah ini dalam terminal.

  1. Dapatkan kunci API

    Cipta akaun, sahkan e-mel anda dan cipta kunci dengan kebenaran Google Search. Gunakan semula kunci sedia ada jika anda sudah memilikinya.

    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

    Pilih bahasa pengaturcaraan dan jalankan contoh dalam terminal yang sama. Setiap pelaksanaan menghantar satu carian.

    Python 3.10+ · Simpan contoh sebagai quickstart.py.

    Pasang
    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. Semak hasil

    Respons yang berjaya mempunyai status: done. Sumber berada dalam results[].organic dan kredit yang digunakan dalam usage.credits.

    Contoh respons (diringkaskan)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Cuba konsol

  1. Cipta akaun atau log masuk. Lengkapkan pengesahan e-mel dan sebarang persediaan akaun yang dipaparkan dalam konsol.
  2. Buka Google Search, pilih sumber Google Search dan mod Realtime, kemudian masukkan battery recycling research. Kembangkan Additional parameters dan tetapkan Page size (num) kepada 5.
  3. Semak permintaan yang dipaparkan dan kredit yang tersedia, kemudian jalankan carian sekali.
  4. Semak respons dan penggunaan. Buka sumber yang dikembalikan untuk menyemak kandungannya sebelum memetik maklumat di luar petikannya.

Teruskan daripada hasil pertama anda

Jika permintaan pertama gagal

FLASHDATA_API_KEY tiada
Tetapkan kunci dalam terminal atau runtime yang sama dengan contoh. Petikan kod ini tidak memuatkan fail .env.
401 / 403
Pastikan kunci atau sambungan aktif dan mempunyai kebenaran google_search.
402
Semak kredit yang tersedia dalam Billing. Pautkan percubaan sedia ada kepada akaun jika anda memerlukan akses pemilik.
429
Ikuti Retry-After. Kekalkan identiti dan bukti pendaftaran yang sama; jangan cipta percubaan lain.
Tamat masa atau status penyerahan tidak diketahui
Semak pelaksanaan sedia ada sebelum mencuba lagi. Pengguna CLI perlu mengekalkan profil dan ID pelaksanaan yang sama; pengguna SDK/API perlu menyimpan ID tugas atau permintaan yang diterima.