Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

Python SDK Quickstart

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

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

    Installieren
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. 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.

    Versteckte Tastenaufforderung · 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. 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
    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"])
    Ausführen
    .venv/bin/python quickstart.py
  4. 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.

    Beispielausgabe
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    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.

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.

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

Was der Python SDK unterstützt

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.

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

Nächste Schritte

Wenn ein Schritt fehlschlägt

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.