# Mula pantas Python SDK

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

Referensi boonical: https://flashdata.dev/ms/docs/guides/flashdata-python
Diulas: 2026-11-04 oleh FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Referensi Sumber dan SDK
- [Dapatkan kunci API](https://flashdata.dev/app/api-keys) — konsol ini akan menciptakan kunci

<a id="application"></a>

## Buat permintaan Python pertamamu

Pasang SDK, atur kunci API dan jalankan satu pencarian. Sambutan adalah kamus Python secara default.

- [Referensi Python SDK](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)
- [PyPI](https://pypi.org/project/flashdata/1.1.0/)

<a id="install"></a>

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

#### Linux / macOS

##### Pasang

```bash
python3 -m venv .venv
.venv/bin/python -m pip install "flashdata==1.1.0"
```


#### Windows PowerShell

##### Pasang

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"
```


- [Pasang Python](https://www.python.org/downloads/)

<a id="key"></a>

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

#### Bash

##### Prompt kunci tersembunyi · Bash

```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
```


#### PowerShell 7

##### Prompt kunci tersembunyi · PowerShell

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Daftar](https://flashdata.dev/signup)
- [Buka API Keys](https://flashdata.dev/app/api-keys)
- [Open Billing](https://flashdata.dev/app/billing)
- [Percobaan agen agen percobaan](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### 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

```python
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"])
```

#### Linux / macOS

##### Jalankan

```bash
.venv/bin/python quickstart.py
```


#### Windows PowerShell

##### Jalankan

```powershell
.\.venv\Scripts\python.exe quickstart.py
```



<a id="result"></a>

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

| Ukrainian | Guna |
| --- | --- |
| 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. |

#### Contoh output

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

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

### Berita Google

Perlu google_news. Artikel dan link sumber dari results[].news[].

#### quickstart.py

```python
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"))
```


### Data meta YouTube

Perlu youtube_metadata. Untuk mencetak judul video, saluran dan durasi dalam detik. Merebut kembali video ID dengan satu yang ingin anda periksa.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
    if response["status"] != "done":
        raise RuntimeError(response)
    for video in response["results"]:
        print(video.get("title"), video.get("channel"))
        print("Seconds:", video.get("duration"))
```


### Transkrip YouTube

Perlu youtube_transcript. Kodator Cetak transkrip otomatis Inggris yang sudah ada dari results[].fullText. Video itu pasti memiliki trek itu; panggilan ini tidak menghasilkan atau menerjemahkan kapsi.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
    if response["status"] != "done":
        raise RuntimeError(response)
    for track in response["results"]:
        print(track.get("fullText", ""))
```


- [Semua metode sumber dan parameter](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

<a id="features"></a>

## Apa yang didukung Python SDK

| Guna | Titik masukan 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. |

- [Contoh muat turun Python Complete](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Konfigurasikan penyimpanan unduhan](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md)
- [format respon Python](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

<a id="asyncio"></a>

## 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

```python
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())
```

- [Konfigurasi klien Async](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

<a id="next"></a>

## Langkah - langkah selanjutnya

- [Cek akun dan hasil disimpan](https://flashdata.dev/ms/docs/guides/sdk-operations/reference.md)
- [Pekerjaan latar belakang dan kelompok](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Datasets Bulk](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [Referensi metode SDK](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## Jika langkah gagal

| Problem | Fix |
| --- | --- |
| 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. |

- [Sejarah permintaan](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Kesalahan dan pemulihan Python](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
