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

API-Referenz

Google Shopping API

API-Schlüssel erstellen

Suchen Sie Google Shopping nach Produkten und holen Sie Preise, Händler, Bewertungen und Produktlinks in strukturiertem JSON ab.

Anfrage erstellen

Erweiterte Parameter

Beginnt bei 1. Jede Seite ist eine separate Anfrage.

Google tbs Ausdruck. Unterstützte Filter variieren je nach Suchtyp.

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_shopping",
    "query": "mechanical keyboard",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
Ergebnisse in der HTTP AntwortX-API-Key-Authentifizierung

Parameter

Senden source und query auf der obersten Ebene. Source-Optionen gehören in params. Optionale Felder können entfallen.

Anfrageinhalt

sourcestring / Erforderlich
Setzen Sie auf google_shopping.
querystring / Erforderlich
Suchanfrage. Unterstützt Google Suchoperatoren wie site: und intitle:.
1 bis 2.000 ZeichenStandard: Nicht eingestellt
paramsobject / Optional
Settings für diese Anfrage.
Standard: {}
callback_urlstring · nullable / Optional
Async und Batch nur. Öffentliche HTTPS Fertigstellung URL auf Port 443, bis zu 2,048 Zeichen. Keine Benutzeranmeldeinformationen oder URL-Fragment. Verwenden Sie null oder einen leeren String für keine Benachrichtigung. Setzen Sie dies in einem Batch auf jede Abfrage, außerhalb von Params.
Standard: Nicht eingestellt

Land, Sprache und Standort

params.glstring / Optional
Zwei-Buchstaben-Ländercode, wie uns, gb, de oder sg. Setzen Sie explizit ein Land auswählen.
Genau 2 ZeichenStandard: Nicht eingestellt
Akzeptiertes Format^[A-Za-z]{2}$
params.hlstring / Optional
Google Schnittstellensprache. Setzen Sie explizit eine Sprache auswählen.
1 bis 35 ZeichenStandard: Nicht eingestellt
Akzeptiertes Format^[A-Za-z0-9-]+$
params.locationstring / Optional
Angeforderter Suchort, vorzugsweise eine Stadt, wie "London, England, United Kingdom". Die Verfügbarkeit hängt vom Suchtyp ab.
1 bis 200 ZeichenStandard: Nicht eingestellt

Pagination

params.numinteger / Optional
Angeforderte Ergebniszahl. FlashData fügt keinen festen Standard hinzu, wenn es weggelassen wird. Die zurückgegebene Anzahl kann sich nach Abfrage und Suchtyp unterscheiden.
1 bis 100, ganze ZahlenStandard: Nicht eingestellt
params.pageinteger / Optional
Angeforderte Ergebnisseite. Ausdrücklich setzen. Jede Seite ist eine separate API-Anforderung.
1 bis 100, ganze ZahlenStandard: Nicht eingestellt

Suchfilter

params.tbsstring / Optional
Angeforderte Google-Suchfilter wie qdr:d für den letzten Tag oder qdr:w für die letzte Woche. Die Verfügbarkeit hängt vom Suchtyp ab.
1 bis 200 ZeichenStandard: Nicht eingestellt
params.autocorrectboolean / Optional
Fordern Sie die Rechtschreibkorrektur mit true an oder fordern Sie sie mit false ab. Angewandtes Verhalten hängt vom Suchtyp ab; Verwenden Sie das Verhalten von Google nicht.
true oder falseStandard: Nicht eingestellt

Antwort

Realtime zurück status: done mit der Suchausgabe in results[0]. Matches sind in results[0].shopping. usage.credits die Ladung aufzeichnet.

Preis ist eine angezeigte Zeichenfolge, kein normalisierter numerischer Betrag. Händler-, Liefer- und Bewertungsfelder sind optional. Listings sind Suchergebnisse, keine Garantie für den aktuellen Bestand oder Preis.

Lesen Sie das Ergebnis

Speichern Sie die erfolgreiche JSON-Antwort als response.json. Speichern Sie dies als read-response.py und führen Sie Python read-response.py aus. Es verwendet nur die Standardbibliothek von Python und stellt keine neue Anforderung.

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "price": item.get("price"), "merchant": item.get("source")}
    for item in result.get("shopping", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))

Verfügbare Felder hängen vom Such- und Suchtyp ab. Optionale Felder können fehlen und zusätzliche Felder können zurückgegeben werden.

Die Anzahl der zurückgegebenen Artikel und searchParameters.num kann von params.num abweichen. Verwenden Sie das zurückgegebene Array, um die tatsächliche Ergebniszahl zu bestimmen.

Alle Antwortfelder
FeldBeschreibung
sourcestringDie angeforderte API-Quelle.
statusstringDies geschieht, wenn die Echtzeitanforderung erfolgreich ist.
created_atstringAntworterstellungszeit im Format ISO 8601.
usage.creditsnumberCredits, die für die anfrage berechnet werden, basierend auf ihrem plan.
results[0].searchParametersobjectSucheinstellungen, die von Google gemeldet werden, wobei die Abfrage als q aufgezeichnet wird. Zurückgegebene Einstellungen können von den angeforderten Werten abweichen.
results[0].shoppingarrayEinkaufssuchergebnisse.
results[0].shopping[].titlestringProduktbezeichnung.
results[0].shopping[].linkstringProduktliste URL.
results[0].shopping[].sourcestring · optionalName des Händlers.
results[0].shopping[].pricestring · optionalAngezeigte Preise einschließlich Währungsformatierung.
results[0].shopping[].deliverystring · optionalAngezeigte Lieferdaten.
results[0].shopping[].ratingnumber · optionalProduktbewertung.
results[0].shopping[].ratingCountinteger · optionalAnzahl der Ratings.
results[0].shopping[].imageUrlstring · optionalProduktbild URL.
results[0].shopping[].positionintegerErgebnisposition.
results[0].shopping[].productIdstring · optionalGoogle Produktkennung, wenn verfügbar.

Die obigen Felder beschreiben die Standardantwort von JSON. JSON, Klartext und Markdown Formate.

Async & Batch-Lebenszyklus

Die Einreichung gibt eine Quittung zurück, keine Ergebnisse. Async erstellt einen Job; batch gibt einen separaten Job in queries[] Für jede akzeptierte Abfrage. Verfolgen und Abrufen jedes Jobs unabhängig.

Einreichen von data.flashdata.dev; lesen Sie den Jobstatus und die Ergebnisse von api.flashdata.dev mit dem gleichen X-API-Key. Die verknüpften API-Grundlagenbeispiele verwenden Python und cURL.

  1. 1. Speichern Sie den Job IDs

    Behalten Sie die Anforderungsfelder dieser Quelle bei, wenn Sie zu Async wechseln. Legen Sie für Batch jede Anfrage in das Abfrage-Array eines JSON-Objekts. Speichern Sie jeden zurückgegebenen Job ID.

    Async Anfrage und Empfang · Batch Anfragestelle

  2. 2. Kontrollstatus

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: Umfrage mit Verzögerung und Respekt Retry-After wenn vorhanden. completed: Ergebnisse holen. failed: Inspektion job.error.

    Lesen Sie job.status, nicht den Status der Eingangsbestätigung.

    Prüfstatus · Python und cURL

    Stellenstatus API-Referenz
  3. 3. Abrufergebnisse

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    Nach Abschluss authentifizieren Sie das gelesene Ergebnis und holen dann den 302-Speicher URL ohne Ihren API-Schlüssel ab. Speichern Sie den JSON innerhalb von 24 Stunden nach Fertigstellung.

    Ergebnisse abrufen · Python und cURL · Antwortformate

    Ergebnis Download API Referenz

Das Abfragen und Abrufen vorhandener Ergebnisse verbraucht keine Abfragegutschriften. Ein Polling-Timeout storniert den Job nicht: Behalten Sie seinen ID, anstatt doppelt abrechenbare Arbeit einzureichen. Fehlercodes und Wiederholverhalten.

Webhooks bei Abschluss

Abonnieren pro Abfrage

Setz callback_url auf der obersten Ebene einer async-Anfrage oder In jeder Abfrage in einer Charge, außen params. Es ist keine separate Webhook-Registrierungsanforderung erforderlich. Realtime-Anfragen senden keine Rückrufe.

Verwenden Sie ein öffentliches HTTPS URL auf Port 443. FlashData POST eine Benachrichtigung für jeden Job, der erreicht wird completed oder failed; Das Ereignis enthält Links, nicht das Ergebnis selbst.

Bestätigung und Überprüfung

Rückkehr 2xx nach dauerhafter Annahme des Ereignisses. Dedupliziert von delivery_id, auch gesendet als X-Delivery-Id. Redirects werden nicht befolgt.

Fehlgeschlagene Lieferungen wiederholen sich mit exponentiellem Backoff, bis zu 8 Versuche insgesamt und höchstens 24 Stunden nach Fertigstellung. Führen Sie Umfragen als Rückfall.

Callbacks sind nicht signiert. Bestätigen Sie den Job ID, den Quell- und Terminalstatus durch die authentifizierter Statusendpunkt vor der Bearbeitung der Benachrichtigung. Die Lieferung ID dient der Deduplizierung, nicht dem Nachweis der Echtheit.

Beispiel Webhook Event und Felder
Illustrative Abschlussmeldung
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "google_shopping",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
FeldBeschreibung
delivery_idstringStabile Lieferkennung. Deduplizieren Sie Benachrichtigungen mit diesem Wert; es wird auch im X-Delivery-Id-Header gesendet.
idstringJob ID.
sourcestringAngeforderte Datenquelle.
statusstringvervollständigt oder fehlgeschlagen.
linksarrayStatus- und Ergebnislinks. Benachrichtigungen enthalten keinen Ergebnisinhalt oder einen API-Schlüssel.
links[].relstringSelbst oder Ergebnisse.
links[].hrefstringAbsolute Management API URL; Authentifizierung mit Ihrem API-Schlüssel.
links[].methodstringGET.

Full Webhook Vertrag und URL Einschränkungen

Fehlerbehebung

Eine abgeschlossene Suche kann weniger Übereinstimmungen enthalten als angefordert. Überprüfung gl, hl, Standort und Filter; optionale Rich-Result-Felder können fehlen.

Für Authentifizierungs-, Balance-, Request-Format- und Rate-Limit-Fehler verwenden Sie die gemeinsame Fehlerreferenz. Ein Einreichungs-Timeout hat möglicherweise immer noch einen Job erstellt; Überprüfen Sie die vorhandene Arbeit, bevor Sie erneut versuchen.

Fehler und Statuscodes · Wann man es erneut versucht · Zinsbindungen

Schritt-für-Schritt Anleitung: Wählen und verfeinern Sie eine Google-Suche

Preise

PläneNutzungssätzepro 1.000 AnfragenAbonnementsInklusive Credits pro Abrechnungszeitraum
Nutzungsabhängige Zahlung1,00 $Keine MonatsgebührBei Bedarf aufladen
Micro0,80 $49,00 $ / Monat1.000 Credits (50,00 $ von API Nutzung) enthalten
Starter0,65 $199,00 $ / Monat4.000 Credits (200,00 $ von API Nutzung) enthalten
Pro0,60 $499,00 $ / Monat10.000 Credits (500,00 $ von API Nutzung) enthalten
Scale0,50 $999,00 $ / Monat20.000 Credits (1.000,00 $ von API Nutzung) enthalten
Business0,40 $1.999,00 $ / Monat40.000 Credits (2.000,00 $ von API Nutzung) enthalten

Ein Kontotarif. Gemeinsames Guthaben für alle drei Produkte. Durch enthaltenes Guthaben gedeckte Nutzung wird nicht erneut berechnet.

Aktuelle Preise und Planlimits