Neuigkeiten22. Okt. 2026Neu

Google Shopping wird jetzt in Commerce Search und Commerce Product unterstützt

API

Google Shopping mit den Chips COMMERCE_SERP und COMMERCE_PRODUCT, die ersten drei Produkte für cerave moisturizing cream mit Preis, Bewertung und Shop sowie die vier Shops, die Google für das erste Produkt listet, von Target mit 4,19 $ bis CVS Pharmacy mit 7,49 $

Durchsuchen Sie mit Commerce Search den Shopping-Tab von Google in den USA und lesen Sie ein Produkt mit Commerce Product, um jeden Shop zu erhalten, den Google dafür listet, mit Preis, Lagerstatus und Produktseite.

Was Sie erhalten

site: "google_shopping" in COMMERCE_SERP: Eine Aufgabe durchsucht den Shopping-Tab von Google in den USA und liefert bis zu 40 Produkte in der Reihenfolge von Google, jedes mit rank, productId, title, price und url.
seller: der Shop auf jeder Produktkarte, etwa Target, Ulta Beauty oder Walmart, dazu rating, reviewCount und imageUrl, wenn die Karte sie zeigt.
COMMERCE_PRODUCT liest jedes Produkt aus diesen Ergebnissen über seine url und liefert title, price, seller, inStock, rating, images und specs.
offers: alle Shops, die Google für das Produkt listet, jeder mit seller, title, price, currency, inStock und der url seiner eigenen Produktseite.

So funktioniert es

Jede Suche liest den Shopping-Tab, den Google für Ihre Anfrage in den USA zeigt, die Seite hinter google.com/search?udm=28. Die url eines Produkts öffnet diese Ergebnisseite und trägt ID und Titel des Produkts nach #; so findet COMMERCE_PRODUCT dasselbe Produkt wieder.

Das Lesen öffnet die Ergebnisseite, klickt auf das Produkt und liest das Panel, das Google zeigt: Shops, Beschreibung, technische Daten und Fotos. price, listPrice, seller und inStock des Produkts stammen vom ersten Shop, den Google als besten Preis führt. Google mischt die Ergebnisse breiter Suchen im Lauf des Tages neu, daher sucht das Lesen das Produkt zuerst über seine Anfrage und danach über seinen Titel.

reviewCount enthält die genaue Zahl, die Google zeigt, bis 1.000; größere Zahlen kürzt Google etwa zu 17K.

Einsatzbereiche

Sehen Sie, welcher Shop den besten Google-Preis für Ihr Produkt hält und wie weit die anderen Shops darüber liegen.
Verfolgen Sie täglich die Produkte, die Google Shopping für eine Kategoriesuche listet, neben den Rankings von Amazon, Walmart und Target für dieselbe Anfrage.
Sammeln Sie die Produktseiten aller Shops, die ein Produkt verkaufen, und lesen Sie die Seite von Target, Walmart oder Ulta mit Commerce Product.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "COMMERCE_SERP",
    "payload": {
      "site": "google_shopping",
      "query": "cerave moisturizing cream",
      "limit": 10
    }
  }'

Felder der Anfrage

taskTypestringPflicht: Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.
payload.sitestringPflicht: Der Shop, der durchsucht wird, etwa amazon, coupang oder rakuten. Die 21 Werte stehen bei der Engine.
payload.querystringPflicht: Die Suchanfrage, so formuliert, wie ein Käufer sie in das Suchfeld des Shops tippt. 1 bis 500 Zeichen.
payload.countrystring: Das Land des Shops, etwa US für amazon oder KR für coupang. Es ist auch der Standardwert.
payload.limitinteger: Anzahl der zurückgegebenen Produkte, 1 bis 40. Standardwert 20.
webhook.urlstring: Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.

Antwort

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

JSON

{
  "success": true,
  "task": {
    "id": "b02ec42c-2ea1-4a6f-ba70-1b3099b8ceff",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T01:32:45.682Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "google_shopping",
    "query": "cerave moisturizing cream",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "16245040360969784676",
        "title": "CeraVe Moisturizing Cream",
        "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream",
        "price": 4.19,
        "currency": "USD",
        "seller": "Target",
        "rating": 4.7
      },
      {
        "rank": 2,
        "productId": "5074307725217910967",
        "title": "CeraVe Moisturizing Cream Pump",
        "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=5074307725217910967&title=CeraVe+Moisturizing+Cream+Pump",
        "price": 17.99,
        "currency": "USD",
        "seller": "Target",
        "rating": 4.7
      },
      "…"
    ]
  }
}

task.statusstring: QUEUED, PROCESSING, dann COMPLETED mit der Antwort oder FAILED mit error.
credits.creditsChargedinteger: Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.
response.returnedCountinteger: Die Anzahl der Produkte in products.
response.productsarray: Die Produkte in der Reihenfolge von Google: rank, productId, title, url, price, currency und seller, dazu rating, reviewCount und imageUrl, wenn die Produktkarte sie zeigt.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Ein Produkt lesen

Übergeben Sie die url eines Produkts aus den Ergebnissen an COMMERCE_PRODUCT. Das ist das Lesen des ersten Produkts oben, gekürzt.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "COMMERCE_PRODUCT",
    "payload": {
      "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream"
    }
  }'

taskTypestringPflicht: Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.
payload.urlstringPflicht: Die url eines Produkts aus einem Commerce-Search-Ergebnis mit google_shopping. Sie öffnet die Ergebnisseite und trägt ID und Titel des Produkts nach #.

JSON

{
  "success": true,
  "task": {
    "id": "9ee619d2-c87f-47ab-93cd-215ef3671734",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T01:36:00.797Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "google_shopping",
    "country": "US",
    "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream",
    "productId": "16245040360969784676",
    "title": "CeraVe Moisturizing Cream",
    "price": 4.19,
    "currency": "USD",
    "inStock": true,
    "seller": "Target",
    "rating": 4.7,
    "images": [
      "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTdoC3RoTxQCkmpSUypL2HqkAR300eBZ_E3W2NCfz2MP4541LroFfQ8ZzNM2XIpm_xS_3c4dZU4_LMYtqQjE89N-Z8wH4Y_gA",
      "…"
    ],
    "specs": [
      { "name": "Benefit", "value": "Moisturizing" },
      { "name": "Form", "value": "Cream" },
      "…"
    ],
    "offers": [
      {
        "seller": "Target",
        "title": "CeraVe Moisturizing Face & Body Cream for Normal to Dry Skin – 1.89 fl oz",
        "url": "https://www.target.com/p/cerave-moisturizing-face-38-body-cream-for-normal-to-dry-skin-8211-1-89-fl-oz/-/A-86467779",
        "price": 4.19,
        "currency": "USD",
        "inStock": true
      },
      {
        "seller": "Ulta Beauty",
        "title": "CeraVe Moisturizing Cream Body and Face Moisturizer - 1.8 oz",
        "url": "https://www.ulta.com/p/moisturizing-cream-body-face-moisturizer-xlsImpprod3530069?sku=2532670",
        "price": 6.99,
        "currency": "USD",
        "inStock": true
      },
      "…"
    ]
  }
}

response.pricenumber: Was Käufer für das Produkt zahlen, wie die Seite es zuerst zeigt, vor Gutscheinen und Versand, in currency (ISO 4217). listPrice ist der durchgestrichene reguläre Preis, wenn er über price liegt.
response.offersarray: Die Shops, die Google für das Produkt listet, in der Reihenfolge von Google: seller, title, price, currency und die url der Produktseite des Shops, dazu listPrice und inStock, wenn die Zeile sie zeigt. Der erste Shop ist der beste Preis bei Google.

Fehler

VALIDATION_ERRORHTTP 422: site liegt außerhalb der 21 Shops, query ist leer oder länger als 500 Zeichen, limit liegt außerhalb von 1 bis 40, oder die Payload enthält ein weiteres Feld. details nennt das Feld.
VALIDATION_ERRORHTTP 422: url fehlt, ist länger als 2.048 Zeichen oder liegt außerhalb der Produktseiten der 18 Shops, oder die Payload enthält ein anderes Feld als url und country. details nennt das Feld.
REGION_UNSUPPORTEDHTTP 422: country ist ein anderes Land als das des Shops, etwa KR mit amazon.
MISSING_API_KEYHTTP 401: Der Header Authorization fehlt, oder sein Schlüssel ist unbekannt, abgelaufen oder widerrufen.
INSUFFICIENT_CREDITSHTTP 402: Das Guthaben liegt unter dem Preis der Aufgabe. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.

Preis

Jede abgeschlossene Suche und jedes abgeschlossene Lesen kostet 3 Credits, wie bei allen anderen Shops. Credits werden abgebucht, wenn die Aufgabe abgeschlossen ist.

Weitere Updates

API22. Okt. 2026Neu
Sehen Sie, wie viel ChatGPT von Ihrer Seite liest
Senden Sie eine Seiten-URL an GEO Score und erhalten Sie den Anteil der Seite, den ChatGPT Search hat, was ChatGPT beim Öffnen der Seite erhält, und für jeden fehlenden Teil den Grund und die Lösung.
API22. Okt. 2026Neu
Wir stellen vor: Commerce Product
Übergeben Sie die URL einer Produktseite von Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando oder 11 weiteren Shops und erhalten Sie Preis, Bestand, Galerie- und Beschreibungsbilder, technische Daten und Optionen im selben Format.

Erhalte Produktneuigkeiten per E-Mail.

RSS-Feed