Documentatie bekijken
Aan de slag
Bel Google Search en YouTube API's direct over HTTP. Stuur één verzoek en lees het JSON antwoord; er is geen SDK vereist.
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_KEYJe sleutel instellen# 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
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 / cURLcurl --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 } }'PowerShell 7+ · Plakken dit eigen PowerShell commando.
Zoeken · PowerShell$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataSearch = @{ Uri = 'https://data.flashdata.dev/v1/queries/realtime' Method = 'Post' Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } ContentType = 'application/json' Body = $flashdataRequest TimeoutSec = 70 MaximumRedirection = 0 SkipHttpErrorCheck = $true ErrorAction = 'Stop' } $flashdataResponse = Invoke-WebRequest @flashdataSearch $flashdataResponse.Content if ($flashdataResponse.StatusCode -ge 400) { throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying." }Node.js 22+ · Bewaar als search.mjs en voer lokaal of op uw server. Gebruikt ingebouwde fetch; geen npm installeren.
search.mjsconst key = process.env.FLASHDATA_API_KEY; if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal."); let response; try { response = await fetch("https://data.flashdata.dev/v1/queries/realtime", { method: "POST", redirect: "error", signal: AbortSignal.timeout(70000), headers: { "X-API-Key": key, "Content-Type": "application/json" }, body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}), }); } catch { throw new Error("Request did not complete. Check History before resubmitting."); } const body = await response.text(); console.log(body); // Print the full response before checking its status. if (!response.ok) { const retryAfter = response.headers.get("retry-after"); throw new Error("HTTP " + response.status + ". See the response above." + (retryAfter ? " Retry-After: " + retryAfter : "")); } let result; try { result = JSON.parse(body); } catch { throw new Error("Expected JSON. Inspect the response above and the API URL."); } if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) { throw new Error("Query did not succeed. Inspect status and error in the response above."); }· JavaScript uitvoerennode search.mjsPython 3.10+ · Opslaan als search.py. Gebruikt alleen de standaardbibliotheek; geen pip installeren. Gebruik python3 of py -3 als dat je Python commando is.
search.pyimport json import os import urllib.error import urllib.request key = os.environ.get("FLASHDATA_API_KEY") if not key: raise SystemExit("Set FLASHDATA_API_KEY in this terminal.") # Do not forward the API key to a redirect destination. class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request( "https://data.flashdata.dev/v1/queries/realtime", data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"), headers={"X-API-Key": key, "Content-Type": "application/json"}, method="POST", ) try: with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response: body = response.read().decode("utf-8") except urllib.error.HTTPError as error: print(error.read().decode("utf-8", errors="replace")) retry_after = error.headers.get("Retry-After") raise SystemExit("HTTP " + str(error.code) + ". See the response above." + (" Retry-After: " + retry_after if retry_after else "")) except (urllib.error.URLError, TimeoutError): raise SystemExit("Request did not complete. Check History before resubmitting.") print(body) # The run command saves this full response to result.json. try: result = json.loads(body) except json.JSONDecodeError: raise SystemExit("Expected JSON. Inspect the response above and the API URL.") if (not isinstance(result, dict) or result.get("error") is True or result.get("status") != "done" or not isinstance(result.get("results"), list)): raise SystemExit("Query did not succeed. Inspect status and error in the response above.")· Python uitvoerenpython -X utf8 search.pyHet 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.
--dump-header response-headers.txt --output result.jsonToegang 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.
(
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
)try {
foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
Write-Host $flashdataPath
$flashdataRead = @{
Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
TimeoutSec = 20
MaximumRedirection = 0
ErrorAction = 'Stop'
}
Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
}
} catch {
throw
}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.