Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

API snelstart

Bel Google Search en YouTube API's direct over HTTP. Stuur één verzoek en lees het JSON antwoord; er is geen SDK vereist.

  1. Authenticeren

    Maak een account aan, verifieer uw e-mail en maak een sleutel met Google Search-permissie. U kunt een bestaande sleutel hergebruiken.

    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 een client en voer het voorbeeld uit in dezelfde terminal. Elk stuurt een POST verzoek naar https://data.flashdata.dev/v1/queries/realtime en print JSON. Authenticeren met X-API-Key; JSON verzenden met Content-Type: application/json.

    cURL 7.76+ · Bash op Linux, macOS of Git Bash. Plakken en rennen.

    Zoeken · Bash / cURL
    curl --fail-with-body --silent --show-error --max-time 70 \
      --request POST https://data.flashdata.dev/v1/queries/realtime \
      --header "X-API-Key: $FLASHDATA_API_KEY" \
      --header 'Content-Type: application/json' \
      --data '{
      "source": "google_search",
      "query": "battery recycling research",
      "params": {
        "num": 5
      }
    }'
  3. Het resultaat controleren

    Bevestig HTTP succes en status: done. Lees brontitels, links en knipsels in results[].organic, en de lading in usage.credits.

    Een lege resultaten of organische lijst met status: done is een geldig leeg resultaat.

    Voorbeeld antwoord
    {
      "source": "google_search",
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    "done" bevestigt dat de query succesvol is voltooid.
    results[0].organic[]
    Zoekresultaten. Controleer of de resultaten niet leeg zijn voordat u het indexeert.
    title / link / snippet
    Brontitel, URL en fragment.
    usage.credits
    Werkelijke kredieten in rekening gebracht voor deze query.

Een antwoord opslaan voor debuggen

Om het volgende beoogde verzoek vast te leggen, voeg deze opties toe aan het cURL commando hierboven. Controleer de bestanden voordat u beslist om een mislukt verzoek opnieuw te proberen.

cURL
--dump-header response-headers.txt --output result.json

Toegang en kredieten controleren

Deze GET-verzoeken lezen identiteit, evenwicht en prijsstelling zonder gebruik te maken van query credits. Verwacht HTTP 200 en controleer de velden hieronder voordat u betaald werk indient.

Account leest: https://api.flashdata.dev/v2. Gegevensverzoeken: https://data.flashdata.dev/v1. Beiden gebruiken X-API-Key; JSON POST-verzoeken gebruiken ook Content-Type: application/json.

Gratis controles · Bash
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
  printf '\n%s\n' "$endpoint"
  curl --fail-with-body --silent --show-error --max-time 20 \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --write-out '\nHTTP %{http_code}\n' \
    "https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)
identity
Bevestig de beoogde accountId, access: "ready", scopes die "google_search" bevatten, en elke expiresAt. accountType is "owned" voor een eigenaarsleutel of "temporary" voor een trialsleutel.
balance
Lees availableCredits. Alle sleutels voor dit account gebruiken hetzelfde saldo.
pricing
Voor prijzen[0] is de broncode google_search en beschikbaar is true. Vergelijk estimatedCredits voor requestCount: 1 met availableCredits. Prijzen en saldi kunnen veranderen voordat ze worden ingediend.

Volgende stappen

Als een stap mislukt

Lees het antwoord afgedrukt in uw terminal. JavaScript en Python rapporteren HTTP fouten en Retry-After aan stderr. Elk voorbeeld legt één keer voor; het wordt niet automatisch opnieuw geprobeerd.

Opdracht ontbreekt of wordt niet ondersteund
Controleer de gewenste versie in het geselecteerde voorbeeld. Gebruik PowerShell 7 in plaats van Windows PowerShell 5.1, of gebruik Bash met cURL 7.76+. JavaScript heeft Node 22+ nodig; Python heeft 3.10+ nodig. Installeer de ontbrekende runtime vanaf de officiële download pagina, heropen de terminal, en stel vervolgens de sleutel opnieuw in.
Ontbrekende sleutel / 401
Stel FLASHDATA_API_KEY in in dit proces en controleer identiteit opnieuw. Lever de volledige actieve API sleutel, zonder een Bearer prefix. Als het verlopen of ingetrokken is, gebruik dan een huidige geautoriseerde credential; plak het niet in de chat.
403
Controleer identity.scopes voor google_search en toegang tot klaar. Verzoek de ontbrekende toestemming van de eigenaar; het veranderen van de bron in het verzoek verleent geen toegang.
402
Lees de balans opnieuw en vergelijk het met de huidige prijs. De eigenaar kan Billing beoordelen. Een uitgeputte proef heeft toegang nodig van de eigenaar via claimen; het creëren van een vervangende proef is geen herstel.
400 / 422
Lees de geretourneerde foutmelding. Controleer de exacte gegevenshost, POST methode, Content-Type en JSON veldnamen. Gebruik rechte citaten en een numerieke params.num, corrigeer dan het afgewezen verzoek.
429
Respect Retry-After indien aanwezig; anders gebruik een begrensde backoff en verminderen concurrency. Loop niet snel, maak nieuwe sleutels aan of registreer een andere proef om de limiet te omzeilen.
HTTP 200 met defecte status of fout
Lees de fout in het lichaam en behoud elke aanvraag of taak ID. Behandel een ontleed JSON-lichaam niet als een succesvolle taak of stuur het automatisch opnieuw in.
Lege resultaten
Als status is voltooid, werkt de authenticatie. Bewaar het lege resultaat of probeer een bredere zoekopdracht als een nieuw betaald verzoek.
Timeout, verbindingsverlies, 5xx of HTML in plaats van JSON
Een POST kan zijn geaccepteerd, zelfs als de respons verloren ging. Controleer History op de oorspronkelijke query en behoud alle geretourneerde IDs voordat u beslist om opnieuw te verzenden. Gratis GET controles kunnen worden opgehaald. Bevestig dat de URL data.flashdata.dev gebruikt, niet de websitehost, en schakel TLS-verificatie niet uit.