Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

Python SDK awalan cepat

Pasang Python SDK dan cetak hasil pencarian dengan beberapa baris kode. Termasuk contoh sinkron dan asincio.

  1. Pasang SDK

    Membutuhkan Python 3.10 +. Jalankan perintah ini dalam direktori projek Anda. Sudah menggunakan lingkungan virtual? Pasang flashdata = = 1.1.0 dengan python lingkungan -m pip sebagai gantinya.

    Instal
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. Otentikasi

    Buat API kunci dengan Google Search izin, atau gunakan kembali kunci yang berwenang. Diatur di terminal ini memakai prompt tersembunyi di bawah ini.

    Lewati prompt jika FLASHDATA_API_KEY telah diset. Contoh-contoh ini membaca variabel secara langsung; mereka tidak memuat berkas .env.

    Prompt kunci tersembunyi Bash
    # 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
  3. Jalankan pencarian

    Simpan ini sebagai quickstart.py, kemudian jalankan dengan lingkungan virtual yang sama. Ini membuat satu permintaan Google Search untuk hingga lima hasil dan judul cetakan, URLs dan kredit yang digunakan.

    quickstart.py
    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)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])
    Jalankan
    .venv/bin/python quickstart.py
  4. Periksa hasil

    Skrip keluar secara normal setelah memeriksa status selesai. Mengharapkan judul sumber dan URLs diikuti oleh Credits digunakan. Daftar organik yang kosong adalah jawaban yang valid; hasil bervariasi dengan permintaan Anda.

    Contoh keluaran
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search hits: judul, link dan snippet. Sumber lain memiliki bidang hasil yang berbeda.
    usage.credits
    Biaya permintaan ini. Sampai lima hasil di sini adalah satu permintaan pencarian.

Coba sumber data lain

Setiap tab adalah skrip yang lengkap. Ganti quickstart.py dengan satu contoh dan jalankan dengan perintah dari langkah 3. Setiap jalankan mengajukan satu permintaan baru; kunci membutuhkan izin sumber yang ditampilkan.

Membutuhkan google_news. Cetak judul artikel dan link sumber dari results[].news[].

quickstart.py
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))

Apa yang Python SDK dukungan

google / youtube
Google Search, Berita, Gambar, Belanja, Video dan Tempat; Penemuan YouTube, metadata, takir, transkrip dan data saluran.
youtube.download
Kirim audio atau video pengiriman ke penyimpanan awan Anda. Membutuhkan ijin youtube_download dan konfigurasi penyimpanan; ikuti contoh pengunduhan lengkap di bawah ini.
jobs / bulk
Simpan pekerjaan yang diterima ID, tunggu untuk penyelesaian dan mengambil hasil. Gunakan sebagian besar untuk video-ID data yang lebih besar dan lanjutkan pekerjaan yang sudah ada setelah restart.
account
Baca akses, keseimbangan, harga, batas dan penggunaan sebelum pekerjaan berulang. Gunakan kembali kunci resmi dari lingkungan atau toko rahasia.
respond_with / accept
Gunakan respond_with = "markdown" untuk Markdown dalam respon ["content"], atau terima = "text/plain" untuk sebuah string. JSON Didictionaries adalah default.

Gunakan asincio

Ganti quickstart.py dengan versi ini dan gunakan perintah lari yang sama. AsyncFlashData mengekspos sumber daya yang sama dengan menunggu. Hal ini masih menunggu respon pencarian realtime; mode="async" menyerahkan sebuah pekerjaan latar belakang sisi pelayan sebagai gantinya.

Dalam Juckyter atau aplikasi dengan loop acara berjalan, gunakan menunggu main () daripada asyncio.run (main (). Gunakan kembali klien dalam loop acara itu.

quickstart.py
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())

Langkah selanjutnya

Jika satu langkah gagal

ModuleNotFoundError
Pasang dan jalankan dengan penerjemah yang sama: .venv/bin/python -m pip tampilkan flashdata (Windows:.\ .venv\ scrits\ python.exe -m pip tampilkan flashdata). Jangan sebutkan naskahmu flashdata.py.
KeyError: FLASHDATA_API_KEY / 401
Atur kunci API aktif di terminal yang sama. Berkas .env saja tidak dimuat oleh contoh ini. Gunakan API kunci, bukan MCP OAuth Token.
403
Berikan izin sumber yang diperlukan oleh contoh untuk kunci ini.
402
Periksa Billing untuk kredit yang tersedia. Jika akses percobaan habis, klaim koneksi untuk menggunakan saldo akun Anda.
429 / APIError
Inspeksi tingkat permintaan error.retry_after dan kurangi. SDK mengirimkan setiap permintaan sekali dan tidak mencoba lagi secara otomatis.
SubmissionUnknownError
Pengiriman timed- out mungkin sudah diterima. Periksa History sebelum mengulanginya; gunakan kembali pekerjaan yang disimpan ID ketika tersedia.
asyncio.run() / running event loop
Gunakan menunggu main () dalam sebuah notebook atau loop kejadian yang ada. Pertahankan asyncio.run (main () untuk skrip standalone.