Dokumentation durchsuchen
Erste Schritte
Rufen Sie Google Search und YouTube APIs direkt über HTTP auf. Senden Sie eine Anfrage und lesen Sie die Antwort von JSON; es ist kein SDK erforderlich.
Authentifizierend
Erstellen Sie ein Konto, überprüfen Sie Ihre E-Mail und erstellen Sie einen Schlüssel mit der Google Search-Berechtigung. Sie können einen vorhandenen Schlüssel wiederverwenden.
Führen Sie den Befehl im Terminal aus und fügen Sie Ihren Schlüssel in die verdeckte Eingabe ein. Überspringen Sie diesen Schritt, wenn FLASHDATA_API_KEY bereits gesetzt ist.
Schlüssel setzen# 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_KEYSchlüssel setzen# 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 flashdataSecureKeySuche ausführen
Wählen Sie einen Client aus und führen Sie das Beispiel im selben Terminal aus. Jeder sendet eine POST-Anfrage an https://data.flashdata.dev/v1/queries/realtime und druckt JSON aus. Authentifizierung mit X-API-Key; senden Sie JSON mit Content-Type: application/json.
cURL 7.76+ · Bash auf Linux, macOS oder Git Bash. Paste und Run.
Suche · 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+ · Fügen Sie diesen nativen PowerShell-Befehl ein.
Suche · 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+ · Speichern Sie als search.mjs und laufen Sie lokal oder auf Ihrem Server. Verwendet eingebauten Fetch; keine npm Installation.
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."); }Laufen · JavaScriptnode search.mjsPython 3.10+ · Speichern Sie als search.py. Verwendet nur die Standardbibliothek; keine pip Installation. Verwenden Sie python3 oder py -3, wenn dies Ihr Befehl Python ist.
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.")Laufen · Pythonpython -X utf8 search.pyErgebnis prüfen
HTTP Erfolg und status: done. Lesen Sie Quelltitel, Links und Snippets in results[].organic und die Ladung in usage.credits.
Eine leere Ergebnisse oder organische Liste mit status: done ist ein gültiges leeres Ergebnis.
Beispielantwort{ "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" bestätigt, dass die Abfrage erfolgreich abgeschlossen wurde.
results[0].organic[]- Suchergebnisse. Überprüfen Sie, ob die Ergebnisse nicht leer sind, bevor Sie sie indizieren.
title / link / snippet- Quelltitel, URL und Auszug.
usage.credits- Tatsächliche credits, die für diese abfrage berechnet werden.
Speichern Sie eine Antwort für Debugging
Um die nächste beabsichtigte Anforderung zu erfassen, fügen Sie diese Optionen dem oben genannten Befehl cURL hinzu. Überprüfen Sie die Dateien, bevor Sie sich entscheiden, eine fehlgeschlagene Anforderung erneut zu versuchen.
--dump-header response-headers.txt --output result.jsonZugriff und Credits prüfen
Diese GET-Anforderungen lesen Identität, Saldo und Preisgestaltung, ohne Abfragegutschriften zu verwenden. Erwarten Sie HTTP 200 und überprüfen Sie die Felder unten, bevor Sie bezahlte Arbeit einreichen.
Konto liest: https://api.flashdata.dev/v2. Datenanforderungen: https://data.flashdata.dev/v1. Beide verwenden X-API-Key; JSON POST-Anforderungen verwenden auch 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- Bestätigen Sie den beabsichtigten accountId, access: "ready", Scopes, die "google_search" und einen beliebigen expiresAt enthalten. accountType ist "owned" für einen Besitzerschlüssel oder "temporary" für einen Testschlüssel.
balance- Lesen Sie availableCredits. Alle Schlüssel für dieses Konto verwenden den gleichen Saldo.
pricing- Für Preise[0] ist die Bestätigungsquelle google_search und verfügbar ist true. Vergleichen Sie estimatedCredits mit requestCount: 1 mit availableCredits. Preise und Salden können sich vor der Einreichung ändern.
Nächste Schritte
Wenn ein Schritt fehlschlägt
Lesen Sie die in Ihrem Terminal gedruckte Antwort. JavaScript und Python melden HTTP Fehler und Retry-After an stderr. Jedes Beispiel wird einmal eingereicht; es wird nicht automatisch wiederholt.
- Befehl fehlende oder nicht unterstützte Option
- Überprüfen Sie die gewünschte Version im ausgewählten Beispiel. Verwenden Sie PowerShell 7 anstelle von Windows PowerShell 5.1 oder verwenden Sie Bash mit cURL 7.76+. JavaScript benötigt Node 22+; Python benötigt 3.10+. Installieren Sie die fehlende Laufzeit von der offiziellen Download-Seite, öffnen Sie das Terminal erneut und setzen Sie den Schlüssel erneut.
- Fehlender Schlüssel / 401
- Setzen Sie FLASHDATA_API_KEY in diesem Prozess und überprüfen Sie die Identität erneut. Geben Sie den vollen aktiven API-Schlüssel ohne Bearer-Präfix ein. Wenn es abgelaufen ist oder widerrufen wurde, verwenden sie einen aktuellen autorisierten anmeldenachweis; fügen sie ihn nicht in den chat ein.
- 403
- Überprüfen Sie identity.scopes für google_search und Zugriff für bereit. Fordern Sie die fehlende Berechtigung vom Eigentümer an; das Ändern der Quelle in der Anforderung gewährt keinen Zugriff.
- 402
- Lesen Sie das Gleichgewicht noch einmal und vergleichen Sie es mit dem aktuellen Preis. Der Besitzer kann Billing überprüfen. Eine erschöpfte Studie benötigt den Zugriff des Besitzers durch Beanspruchung; das Erstellen einer Ersatzstudie ist keine Wiederherstellung.
- 400 / 422
- Lesen Sie die zurückgegebene Fehlermeldung. Überprüfen Sie den genauen Datenhost, die POST-Methode, die Feldnamen Content-Type und JSON. Verwenden Sie gerade Anführungszeichen und eine numerische params.num, dann korrigieren Sie die abgelehnte Anforderung.
- 429
- Respektieren Sie Retry-After, falls vorhanden; ansonsten verwenden Sie ein begrenztes Backoff und reduzieren Sie die Parallelität. Schleifen Sie nicht schnell, erstellen Sie neue Schlüssel oder registrieren Sie eine andere Testversion, um das Limit zu umgehen.
- HTTP 200 mit fehlgeschlagenem Status oder Fehler
- Lesen Sie den Fehler im Körper und bewahren Sie jede Anfrage oder jeden Job ID auf. Behandeln Sie einen analysierten JSON-Körper nicht als erfolgreiche Aufgabe oder senden Sie ihn automatisch erneut ab.
- Leerergebnisse
- Wenn der Status abgeschlossen ist, funktionierte die Authentifizierung. Behalten Sie das leere Ergebnis bei oder versuchen Sie eine breitere Abfrage als neue bezahlte Anfrage.
- Timeout, Verbindungsverlust, 5xx oder HTML anstelle von JSON
- Ein POST wurde möglicherweise akzeptiert, auch wenn seine Antwort verloren ging. Überprüfen Sie History für die ursprüngliche Abfrage und bewahren Sie alle zurückgegebenen IDs auf, bevor Sie sich für das erneute Senden entscheiden. Kostenlose GET-Checks können erneut getestet werden. Bestätigen Sie, dass URL data.flashdata.dev verwendet, nicht den Website-Host, und deaktivieren Sie die TLS-Verifizierung nicht.