Documentatie bekijken
Aan de slag
Installeer de Python SDK en print zoekresultaten met een paar regels code. Omvat synchrone en asyncio voorbeelden.
Installeer de SDK
Vereist Python 3.10+. Voer deze commando's uit in uw projectmap. Gebruik je al een virtuele omgeving? Installeer flashdata==1.1.0 met de python -m pip van die omgeving in plaats daarvan.
Installerenpython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"Installerenpy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"Authenticeren
Maak een API sleutel met Google Search toestemming, of hergebruik een geautoriseerde sleutel. Zet het in deze terminal met behulp van de verborgen prompt hieronder.
De prompt overslaan als FLASHDATA_API_KEY al is ingesteld. Deze voorbeelden lezen de variabele direct; ze laden geen .env-bestanden.
Verborgen sleutelprompt · 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_KEYVerborgen sleutelprompt · 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 flashdataSecureKeyEen zoekopdracht uitvoeren
Sla dit op als quickstart.py en voer het vervolgens uit met dezelfde virtuele omgeving. Het maakt een Google Search verzoek voor maximaal vijf resultaten en print titels, URLs en gebruikte 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"])Uitvoeren.venv/bin/python quickstart.pyUitvoeren.\.venv\Scripts\python.exe quickstart.pyHet resultaat controleren
Het script eindigt normaal nadat de controlestatus is voltooid. Verwacht brontitels en URLs gevolgd door gebruikte Credits. Een lege organische lijst is een geldig antwoord; de resultaten variëren met uw zoekopdracht.
VoorbeelduitvoerBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search hits: titel, link en knipsel. Andere bronnen hebben verschillende resultaatvelden.
usage.credits- Kosten van dit verzoek. Tot vijf resultaten hier zijn één zoekopdracht.
Probeer een andere gegevensbron
Elk tabblad is een compleet script. Vervang quickstart.py door één voorbeeld en voer het uit met het commando van stap 3. Elke run dient een nieuw verzoek in; de sleutel heeft de getoonde bron toestemming nodig.
Vereist google_news. Print artikel titels en bron links van 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"))Vereist youtube_metadata. Drukt de videotitel, kanaal en duur in seconden af. Vervang de video ID door een die u wilt inspecteren.
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"))Vereist youtube_transcript. Drukt een bestaand Engels automatisch transcript af van results[].fullText. De video moet die track hebben; deze call genereert of vertaalt geen bijschriften.
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", ""))Wat de Python SDK ondersteunt
google / youtube- Google Search, Nieuws, Afbeeldingen, Winkelen, Video's en Plaatsen; YouTube ontdekking, metadata, bijschriften, transcripten en kanaalgegevens.
youtube.download- Stuur een audio- of videoleveringstaak naar uw cloudopslag. Vereist youtube_download toestemming en opslag configuratie; volg het volledige download voorbeeld hieronder.
jobs / bulk- Bewaar de geaccepteerde taak ID, wacht op voltooiing en haal resultaten op. Gebruik bulk voor grotere video-ID datasets en hervat bestaande taken na een herstart.
account- Lees toegang, evenwicht, prijzen, limieten en gebruik voordat u opnieuw werkt. Hergebruik een geautoriseerde sleutel uit uw omgeving of geheime winkel.
respond_with / accept- Gebruik respond_with="markdown" voor Markdown in respons["content"], of accepteer="text/plain" voor een string. JSON woordenboeken zijn de standaard.
Asyncio gebruiken
Vervang quickstart.py door deze versie en gebruik hetzelfde commando. AsyncFlashData stelt dezelfde bronnen bloot met wachten. Dit wacht nog steeds op een real-time zoekrespons; mode="async" geeft in plaats daarvan een server-side achtergrondtaak.
In Jupyter of een applicatie met een draaiende event loop, gebruik wacht main() in plaats van asyncio.run(main()). Hergebruik de client binnen die event-lus.
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())Volgende stappen
Als een stap mislukt
- ModuleNotFoundError
- Installeer en voer uit met dezelfde tolk: .venv/bin/python -m pip toon flashdata (Windows: .\.venv\Scripts\python.exe -m pip toon flashdata). Noem uw script flashdata.py niet.
- KeyError: FLASHDATA_API_KEY / 401
- Stel een actieve API sleutel in in dezelfde terminal. Een .env-bestand alleen wordt niet door dit voorbeeld geladen. Gebruik een API sleutel, geen MCP OAuth token.
- 403
- Geef de bron toestemming die het voorbeeld van deze sleutel vereist.
- 402
- Controleer Billing op beschikbare credits. Als de toegang tot trials is uitgeput, claimen de verbinding om uw rekeningsaldo te gebruiken.
- 429 / APIError
- Inspecteer error.retry_after en verminder de aanvraagsnelheid. De SDK stuurt elk verzoek eenmaal en probeert het niet automatisch opnieuw.
- SubmissionUnknownError
- Een getimede indiening kan reeds worden aanvaard. Controleer History voordat u het herhaalt; hergebruik een opgeslagen taak ID indien beschikbaar.
- asyncio.run() / running event loop
- Gebruik wacht main() in een notebook of bestaande event loop. Houd asyncio.run(main()) voor een standalone script.