Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

Python SDK snelstart

Installeer de Python SDK en print zoekresultaten met een paar regels code. Omvat synchrone en asyncio voorbeelden.

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

    Installeren
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. 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_KEY
  3. Een 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.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"])
    Uitvoeren
    .venv/bin/python quickstart.py
  4. Het 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.

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

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

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.

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

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.