Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

API Quickstart

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.

  1. 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_KEY
  2. Suche 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 / 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. Ergebnis 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.

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

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

Kostenlose Schecks · 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
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.