# Python SDK hızlı başlangıç

Python SDK'u yükleyin ve birkaç kodla arama sonuçlarını yazdırın. senkronize ve asyncio örneklerini içerir.

Canonical referans: https://flashdata.dev/tr/docs/guides/flashdata-python
İnceleme: 2026-11-04 Tarafından FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Kaynak ve SDK referans
- [API anahtarı alın](https://flashdata.dev/app/api-keys) — Konsolda bir anahtar oluşturun

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

## İlk Python isteğinizi yapın

SDK'u yükleyin, API anahtarını ayarlayın ve bir arama çalıştırın. Yanıtlar Python sözlükleri varsayılan olarak.

- [Python SDK referans](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>

### Yüklemek için SDK

Python 3.10+'yı gerektirir. Bu komutları proje rehberinizde çalıştırın. Zaten bir sanal ortam kullanıyor mu? Flashdata==1.1.0'u bu çevrenin python ile yükleyin - yerine pip.

#### Linux / macOS

##### Yükle

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


#### Windows PowerShell

##### Yükle

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


- [Yükleme yükleme Python](https://www.python.org/downloads/)

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

### Kimlik Doğrulama

API anahtarını Google Search izni ile oluşturun veya yetkili bir anahtarı yeniden kullanın. Bu terminalde aşağıda gizli bir şekilde ayarlayın.

FLASHDATA_API_KEY'un zaten ayarlandığı gibi hızlı bir şekilde girin. Bu örnekler değişkeni doğrudan okur; .env dosyaları yüklemezler.

#### Bash

##### Gizli anahtar · 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

##### Gizli anahtar · 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
```


- [Kaydol](https://flashdata.dev/signup)
- [API Keys sayfasını aç](https://flashdata.dev/app/api-keys)
- [Açık Billing](https://flashdata.dev/app/billing)
- [Agent deneme kurulumu](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)

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

### Arama çalıştırın

Bunu quickstart.py olarak kurtar, sonra aynı sanal ortamda çalıştırın. Bu, beş sonuca kadar Google Search isteği yapar ve listeler, URLs ve kullanılan krediler yapar.

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

##### Çalıştır

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


#### Windows PowerShell

##### Çalıştır

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



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

### Sonucu kontrol edin

Senaryo normalde durumu kontrol ettikten sonra çıkıyor. Kaynak başlıkları ve URLs, kullanılan Krediler tarafından takip edildi. Boş organik bir liste geçerli bir yanıttır; sonuçlar sorgunuzla değişir.

| Field | Kullanım |
| --- | --- |
| results[].organic[] | Google Search hit: başlık, bağlantı ve parçalar. Diğer kaynaklar farklı sonuç alanları vardır. |
| usage.credits | Bu talebin maliyeti. Buradaki beş sonuça kadar bir arama isteği. |

#### Örnek çıktı

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


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

## Başka bir veri kaynağı deneyin

Her sekme tam bir senaryodur. quickstart.py'u bir örnekle değiştirin ve 3 adımdan kumanda ile çalıştırın. Her işletme yeni bir istek sunar; anahtarın gösterilen kaynak iznine ihtiyacı vardır.

### Google News

google_news izni gerekir. results[].news[] içindeki haber başlıklarını ve kaynak bağlantılarını yazdırır.

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


### YouTube metadata

youtube_metadata'u gerektirir. Video unvanı, kanal ve saniyeler içinde. Video ID'u denetim etmek istediğiniz biri ile değiştirin.

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


### YouTube transcript

youtube_transcript'u gerektirir. results[].fullText.'dan mevcut bir İngilizce otomatik transkript Videonun bu yolda olması gerekir; bu çağrı oluşturmaz veya komutlar çevirmez.

#### 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", ""))
```


- [Tüm kaynak yöntemleri ve parametreleri](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

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

## Python SDK ne destekliyor

| Kullanım | SDK giriş noktaları |
| --- | --- |
| google / youtube | Google Search, Haberler, Görüntüler, Alışveriş, Videolar ve Yerler; YouTube keşif, metadata, altyazılar, transkriptler ve kanal verileri. |
| youtube.download | Bulut depolamanıza bir ses veya video teslimat işi gönderin. youtube_download izin ve depolama yapılandırması gerektirir; aşağıdaki tam indirme örneği izleyin. |
| jobs / bulk | Kabul edilen işi kurtarmak ID, tamamlanmak ve sonuçları almak için bekleyin. Daha büyük video-ID veri setleri için büyük miktarda kullanın ve bir yeniden başlatmadan sonra mevcut işlere devam edin. |
| account | Erişim, denge, fiyatlandırma, limitler ve kullanım tekrarlanan çalışmadan önce. Çevrenizden veya gizli mağazanızdan yetkili bir anahtar kullanın. |
| respond_with / accept | respond_with="markdown" için Markdown'u yanıt olarak kullanın ("content") veya bir dize için kabul ="text/plain"'u kabul edin. JSON sözlükleri varsayılandir. |

- [Tamam Python indirme örneği](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Configure download storage](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)
- [Python yanıt formatları](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

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

## Asyncio kullanın

quickstart.py'u bu sürümle değiştirin ve aynı koşu komutunu kullanın. AsyncFlashData, aynı kaynakları bekleyerek ortaya koyar. Bu hala gerçek zamanlı bir arama yanıtını bekler; mode="async" bunun yerine bir sunucu arka plan işi gönderir.

Jupyter veya çalışan bir olay döngüsü ile bir uygulama, asyncio.run(main() yerine ana() kullanın. Müşteriyi bu olay döngüsü içinde yeniden kullanın.

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

- [Async müşteri konfigürasyonu](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

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

## Sonraki adımlar

- [Hesap kontrolleri kontrol eder ve sonuçları kurtarın](https://flashdata.dev/tr/docs/guides/sdk-operations/reference.md)
- [Arka plan işleri ve toplu toplu](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk datasets](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDK yöntemi referans](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

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

## Bir adım başarısız olursa

| Problem Sorun Problem Problem Problem | Fix Fix |
| --- | --- |
| ModuleNotFoundError | Aynı tercümanla yükleme ve koşma: .venv/bin/python -m pip show flashdata (Windows: .\.venv\Scripts\python.exe -m pip show flashdata). Senaryo flashdata.py adını kullanmayın. |
| KeyError: FLASHDATA_API_KEY / 401 | Aynı terminalde aktif bir API anahtarı ayarlayın. Tek başına bir .env dosyası bu örnek tarafından yüklenemez. Bir API anahtarı kullanın, bir MCP OAuth token değil. |
| 403 | Örneğin bu anahtara gerekli olan kaynak iznini verin. |
| 402 | Billing'u mevcut krediler için kontrol edin. Eğer deneme erişimi tükenmişse, hesabınızı bakiyenizi kullanmak için bağlantıyı iddia edin. |
| 429 / APIError | Inspect error.retry_after ve istek oranını azaltır. SDK her isteği bir kez gönderir ve otomatik olarak yeniden denemez. |
| SubmissionUnknownError | Bir zaman teslimi zaten kabul edilebilir. History'u tekrarlamadan önce kontrol edin; mevcut olduğunda kaydedilen ID'u yeniden kullanın. |
| asyncio.run() / running event loop | Bir not defteri veya mevcut olay döngüsünde ana()'ı bekleyin. asyncio.run(main()) bir standalone senaryosu için tutun. |

- [Tarih İstek Tarihi](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python hataları ve kurtarma](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
