Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Mula pantas Python SDK

Anstal Python SDK dan cetak hasil pencarian dengan beberapa baris kode. Ada juga contoh sinkronis dan asyncio.

  1. Pasang SDK

    Kemudi membutuhkan Python 3.10+. Jalankan perintah ini dalam direktori projek anda. Sudah menggunakan lingkungan virtual? Anstal flashdata==1.1.0 dengan python lingkungan itu -m pip sebagai gantinya.

    Pasang
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. Autentifikasi

    Aathenthez Membuat kunci API dengan izin Google Search, atau menggunakan kembali kunci yang berwenang. Diset dalam terminal ini menggunakan tanda di bawah.

    Skip ke prompt jika FLASHDATA_API_KEY sudah ditetapkan. Contoh-contoh ini beberapa contoh 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 carian

    Simpan ini sebagai quickstart.py, kemudian jalankan dengan lingkungan virtual yang sama. Ia membuat satu permintaan Google SearchQ untuk hingga lima hasil dan mencetak gelar, 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. Semak hasil

    script keluar normal setelah pemeriksaan status dilakukan. Gelar sumber dan URLs diikuti oleh Credits digunakan. Daftar organik kosong adalah tanggapan yang sah; hasil bervariasi dengan pertanyaan Anda.

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

Coba sumber data lain

Setiap tab adalah naskah lengkap. Megantikan quickstart.py dengan satu contoh dan jalankan dengan perintah dari langkah 3. Setiap run menyerahkan satu permintaan baru; kunci membutuhkan izin sumber yang ditunjukkan.

Perlu google_news. 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 didukung Python SDK

google / youtube
Google Search, Berita, Gambar, Belanja, Video dan Tempat; Penemuan YouTube, metadata, kapsi, transkrip dan data saluran.
youtube.download
Kirimkan pekerjaan pengiriman audio atau video ke penyimpanan awan Anda. Ketergantungan memerlukan izin youtube_download dan konfigurasi penyimpanan; ikuti contoh unduhan lengkap di bawah ini.
jobs / bulk
Simpan pekerjaan yang diterima ID, tunggu penyelesaian dan hasil pengambilan. Mesin pukal digunakan untuk dataset video-ID yang lebih besar dan melanjutkan kembali pekerjaan yang sudah ada setelah restart.
account
KISAH, keseimbangan, harga, batas, dan penggunaan yang mudah dibaca sebelum pekerjaan yang berulang. Anda menggunakan kembali kunci yang sah dari lingkungan atau toko rahasia Anda.
respond_with / accept
Gunakan respond_with="markdown" untuk Markdown sebagai respon["content"], atau terima="text/plain" untuk sebuah string. Kamus JSON adalah standar.

Zudha menggunakan asyncio

Megantikan quickstart.py dengan versi ini dan menggunakan perintah lari yang sama. AndikasyncFlashData mengekspos sumber daya yang sama dengan menunggu. Ini masih menunggu respon pencarian realtime; mode="async" menyerahkan pekerjaan latar belakang sisi-server sebagai gantinya.

Di Jupyter atau aplikasi dengan loop event yang berjalan, gunakan tunggu main() alih-alih asyncio.run(main)). Gunakan kembali klien dalam lingkaran peristiwa 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 - langkah selanjutnya

Jika langkah gagal

ModuleNotFoundError
Pasang dan jalankan dengan penterjemah yang sama: .venv/bin/python -m pip show flashdata (Windows: .\.venv\Scripts\python.exe -m pip show flashdata). Jangan namakan skrip anda flashdata.py.
KeyError: FLASHDATA_API_KEY / 401
API aktif di terminal yang sama. Sebuah berkas .env saja tidak dimuat oleh contoh ini. Use an API Kunci, bukan kunci MCP OAuth token.
403
Berikan izin sumber yang diperlukan oleh contoh kunci ini.
402
Periksa Billing untuk kredit yang tersedia. Jika akses pengadilan telah habis, klaim koneksi untuk menggunakan saldo rekening Anda.
429 / APIError
Periksa error.retry_after dan kurangi nilai permintaan. SDK mengirim setiap permintaan sekali dan tidak mencoba lagi secara otomatis.
SubmissionUnknownError
Pengiriman timed-out mungkin sudah diterima. Periksa History sebelum mengulanginya; gunakan kembali pekerjaan tersimpan ID bila tersedia.
asyncio.run() / running event loop
Use wait main() dalam notebook atau loop event yang ada. Keep asyncio.run(main()) untuk skrip standalone.