Dokumentation durchsuchen
Erste Schritte
Installieren Sie die Python SDK und drucken Sie die Suchergebnisse mit ein paar Zeilen Code. Enthält synchrone und asyncio Beispiele.
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.
Installierenpython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"Installierenpy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"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_KEYVersteckte Tastenaufforderung · 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 flashdataSecureKeySuche 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.pyimport 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.pyAusführen.\.venv\Scripts\python.exe quickstart.pyErgebnis 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.
BeispielausgabeBattery recycling research https://example.org/recycling Credits used: 0.02results[].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[].
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"))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.
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"))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.
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", ""))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.
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.