Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

Snelstart

Voer je eerste Google-zoekopdracht uit en ontvang gestructureerde resultaten voor je app of AI-agent.

Begin met je AI-agent

Geef deze prompt aan een agent met terminaltoegang. Die stelt FlashData in en voert één zoekopdracht uit.

Je eerste API-aanroep uitvoeren

Schrijf je liever zelf de code? Volg deze drie stappen in je terminal.

  1. Een API-sleutel aanmaken

    Maak een account, verifieer je e-mailadres en maak een sleutel met Google Search-toestemming. Heb je al een sleutel? Gebruik die hier.

    Voer dit uit in je terminal en plak je sleutel in de verborgen invoer. Sla deze stap over als FLASHDATA_API_KEY al is ingesteld.

    Je sleutel instellen
    # 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
  2. Een zoekopdracht uitvoeren

    Kies je programmeertaal en voer het voorbeeld uit in dezelfde terminal. Elke uitvoering verzendt één zoekopdracht.

    Python 3.10+ · Sla het voorbeeld op als quickstart.py.

    Installeren
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    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)
        print(json.dumps(response, indent=2))
    Uitvoeren
    python quickstart.py
  3. Het resultaat controleren

    Een geslaagd antwoord bevat status: done. Bronnen staan in results[].organic en het verbruik in usage.credits.

    Voorbeeldantwoord (ingekort)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

De console proberen

  1. Maak een account of log in. Verifieer je e-mailadres en voltooi de accountinstellingen die de console toont.
  2. Open Google Search, kies de bron Google Search en de modus Realtime en voer battery recycling research in. Open Additional parameters en stel Page size (num) in op 5.
  3. Controleer de getoonde aanvraag en je beschikbare credits. Voer de zoekopdracht daarna één keer uit.
  4. Bekijk het antwoord en het verbruik. Open een teruggegeven bron om de inhoud te controleren voordat je meer citeert dan het fragment.

Verder bouwen op je eerste resultaat

Als de eerste aanvraag mislukt

FLASHDATA_API_KEY ontbreekt
Stel de sleutel in dezelfde terminal of runtime in als het voorbeeld. Deze fragmenten laden geen .env-bestanden.
401 / 403
Controleer of de sleutel of verbinding actief is en google_search-toestemming heeft.
402
Controleer je beschikbare credits in Billing. Koppel een bestaande proefperiode als toegang van de eigenaar nodig is.
429
Volg Retry-After. Behoud dezelfde identiteit en hetzelfde registratiebewijs; maak geen nieuwe proefperiode aan.
Timeout of onduidelijke verzendstatus
Controleer de bestaande uitvoering voordat je opnieuw probeert. CLI-gebruikers behouden hetzelfde profiel en dezelfde uitvoerings-ID; SDK/API-gebruikers bewaren elke teruggegeven taak- of aanvraag-ID.