# Python SDK Quickstart

Installieren Sie die Python SDK und drucken Sie die Suchergebnisse mit ein paar Zeilen Code. Enthält synchrone und asyncio Beispiele.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/flashdata-python
Test: 2026-11-04 von FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Quelle und SDK Referenz
- [API-Schlüssel erstellen](https://flashdata.dev/app/api-keys) — Erstellen eines Schlüssels in der Konsole

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

## Machen Sie Ihre erste Python-Anfrage

Installieren Sie den SDK, legen Sie Ihren API-Schlüssel fest und führen Sie eine Suche aus. Antworten sind standardmäßig Python-Wörterbücher.

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

### Installieren Sie den SDK

Erfordert Python 3.10+. Führen Sie diese Befehle in Ihrem Projektverzeichnis aus. Verwenden Sie bereits eine virtuelle Umgebung? Installieren Sie flashdata==1.1.0 stattdessen mit dem Python dieser Umgebung -m pip.

#### Linux / macOS

##### Installieren

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


#### Windows PowerShell

##### Installieren

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


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

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

### Authentifizierend

Erstellen Sie einen API-Schlüssel mit der Google Search-Berechtigung oder verwenden Sie einen autorisierten Schlüssel erneut. Setzen Sie es in diesem Terminal mit der versteckten Eingabeaufforderung unten.

Überspringen Sie die Eingabeaufforderung, wenn FLASHDATA_API_KEY bereits eingestellt ist. Diese Beispiele lesen die Variable direkt; sie laden keine .env-Dateien.

#### Bash

##### Versteckte Tastenaufforderung · 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

##### Versteckte Tastenaufforderung · 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
```


- [Registrieren](https://flashdata.dev/signup)
- [API Keys öffnen](https://flashdata.dev/app/api-keys)
- [Open Billing](https://flashdata.dev/app/billing)
- [Einrichtung eines Agentenversuchs](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md)

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

### Suche ausführen

Speichern Sie dies als quickstart.py und führen Sie es dann mit der gleichen virtuellen Umgebung aus. Es macht eine Google Search-Anforderung für bis zu fünf Ergebnisse und druckt Titel, URLs und verwendete Credits.

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

##### Ausführen

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


#### Windows PowerShell

##### Ausführen

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



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

### Ergebnis prüfen

Das Skript wird normalerweise beendet, nachdem der Status überprüft wurde. Erwarten Sie Quelltitel und URLs gefolgt von verwendeten Credits. Eine leere organische liste ist eine gültige antwort; die ergebnisse variieren je nach abfrage.

| Feld | Verwendung |
| --- | --- |
| results[].organic[] | Google Search Hits: Titel, Link und Snippet. Andere Quellen haben unterschiedliche Ergebnisfelder. |
| usage.credits | Kosten für diesen Antrag. Bis zu fünf Ergebnisse sind hier eine Suchanfrage. |

#### Beispielausgabe

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


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

## Probieren Sie eine andere Datenquelle

Jeder Tab ist ein komplettes Skript. Ersetzen Sie quickstart.py durch ein Beispiel und führen Sie es mit dem Befehl aus Schritt 3 aus. Jeder Durchlauf sendet eine neue Anforderung; der Schlüssel benötigt die angezeigte Quellberechtigung.

### Google Nachrichten

Erfordert google_news. Druckt Artikeltitel und Quelllinks aus 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"))
```


### YouTube-Metadaten

Erfordert youtube_metadata. Druckt den Videotitel, den Kanal und die Dauer in Sekunden. Ersetzen Sie das Video ID durch eines, das Sie inspizieren möchten.

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

Erfordert youtube_transcript. Druckt ein vorhandenes englisches automatisches Transkript aus results[].fullText. Das video muss diesen track haben; dieser aufruf generiert oder übersetzt keine beschriftungen.

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


- [Alle Quellenmethoden und Parameter](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

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

## Was der Python SDK unterstützt

| Verwendung | SDK-Eingangspunkte |
| --- | --- |
| google / youtube | Google Search, Nachrichten, Bilder, Einkaufen, Videos und Orte; YouTube Discovery, Metadaten, Beschriftungen, Transkripte und Kanaldaten. |
| youtube.download | Senden Sie einen Audio- oder Video-Lieferauftrag an Ihren Cloud-Speicher. Erfordert youtube_download-Berechtigung und Speicherkonfiguration; folgen Sie dem vollständigen Download-Beispiel unten. |
| jobs / bulk | Speichern Sie den akzeptierten Job ID, warten Sie auf den Abschluss und rufen Sie die Ergebnisse ab. Verwenden Sie Bulk für größere Video-ID-Datensätze und nehmen Sie bestehende Jobs nach einem Neustart wieder auf. |
| account | Lesen Sie Zugang, Balance, Preise, Limits und Nutzung vor wiederkehrenden Arbeiten. Verwenden Sie einen autorisierten Schlüssel aus Ihrer Umgebung oder Ihrem Secret Store wieder. |
| respond_with / accept | Verwenden Sie respond_with="markdown" für Markdown in response["content"] oder accept="text/plain" für einen String. JSON-Wörterbücher sind standardmäßig. |

- [Komplettes Python Download Beispiel](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Konfigurieren des Download-Speichers](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)
- [Python Antwortformate](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

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

## Asyncio verwenden

Ersetzen Sie quickstart.py durch diese Version und verwenden Sie den gleichen Befehl. AsyncFlashData stellt die gleichen Ressourcen mit await zur Verfügung. Dieser wartet immer noch auf eine Echtzeit-Suchantwort; mode="async" sendet stattdessen einen serverseitigen Hintergrundjob.

Verwenden Sie in Jupyter oder einer Anwendung mit einer laufenden Ereignisschleife await main() anstelle von asyncio.run(main()). Verwenden Sie den Client innerhalb dieser Ereignisschleife erneut.

### 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-Clientkonfiguration](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

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

## Nächste Schritte

- [Kontoprüfungen und gespeicherte Ergebnisse](https://flashdata.dev/de/docs/guides/sdk-operations/reference.md)
- [Hintergrundjobs und Batch](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk-Datensätze](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDK-Verfahren](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

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

## Wenn ein Schritt fehlschlägt

| Problem | Fixpunkt |
| --- | --- |
| ModuleNotFoundError | Installieren und ausführen mit dem gleichen Interpreter: .venv/bin/python -m pip zeigen Flashdaten (Windows: .\.venv\Scripts\python.exe -m pip zeigen Flashdaten). Nennen Sie Ihr Skript nicht flashdata.py. |
| KeyError: FLASHDATA_API_KEY / 401 | Legen Sie einen aktiven API-Schlüssel im selben Terminal fest. Eine .env-Datei allein wird von diesem Beispiel nicht geladen. Verwenden Sie einen API-Schlüssel, kein MCP OAuth-Token. |
| 403 | Geben Sie diesem Schlüssel die für das Beispiel erforderliche Quellberechtigung. |
| 402 | Überprüfen Sie Billing für verfügbare Credits. Wenn der Testzugriff erschöpft ist, fordern Sie die Verbindung an, um Ihren Kontostand zu verwenden. |
| 429 / APIError | Überprüfen Sie error.retry_after und reduzieren Sie die Anforderungsrate. Der SDK sendet jede Anfrage einmal und wiederholt sie nicht automatisch. |
| SubmissionUnknownError | Eine zeitgesteuerte Einreichung kann bereits akzeptiert werden. Überprüfen Sie History, bevor Sie es wiederholen; Verwenden Sie einen gespeicherten Job ID, wenn verfügbar. |
| asyncio.run() / running event loop | Verwenden Sie await main() in einem Notizbuch oder einer vorhandenen Ereignisschleife. Halten Sie asyncio.run(main()) für ein eigenständiges Skript. |

- [Anfrageverlauf](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python Fehler und Wiederherstellung](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
