NeuigkeitenNeu

Neu: Product Lookup

Product Lookup
Product-Lookup-Vergleich von belif Moisturizing Eye Bomb mit zwei Konkurrenzprodukten: Händlereinträge, Preise und Bewertungen bei ChatGPT, Google AI Overviews, AI Mode und Copilot und in wie vielen von acht Antworten auf Shopping-Prompts jedes Produkt erschien

Product Lookup fragt die KI-Shopping-Engines nach Ihrem Produkt und denen Ihrer Konkurrenz und liefert pro Engine die Händler, Preise und Bewertungen, die jede Antwort zeigt.

Was Sie erhalten

  • engines[]: ob die Antworten jeder Engine Ihr Produkt zeigten (found), und jeder gezeigte Händlereintrag mit Preis, Verfügbarkeit, Bewertung, Anzahl der Rezensionen und Herkunftskatalog.
  • modelSees: Titel, Beschreibung, Bewertung und Rezensionszahl, die das antwortende Modell von ChatGPT zu einem Eintrag erhielt, damit Sie Ihr Produkt so sehen, wie das Modell es liest.
  • comparison[]: Ihr Produkt und bis zu fünf Konkurrenzprodukte nebeneinander auf jeder Engine, mit Einträgen, Händlern, dem Eintrag mit den meisten Rezensionen und der Preisspanne.
  • prompts[]: bis zu drei Shopping-Prompts, mit den Produkten Ihrer Abfrage, die jede Antwort zeigte und nannte.
  • citedPages und summary.citedDomains: die Seiten, die jede Antwort zitiert, über alle Engines nach Website gruppiert.

So funktioniert es

Senden Sie einen Produktnamen und einen Markt. In US fragt Product Lookup ChatGPT „Buy …“ und „Find the best price for …“ und stellt Google AI Overviews, Google AI Mode und Bing Copilot den Produktnamen. In KR fragt es Naver AI Tab und Google AI Mode nach dem Namen und ChatGPT mit „… 구매“ und „… 최저가“. Jedes Konkurrenzprodukt bekommt dieselben Fragen, und jeder Shopping-Prompt geht im Wortlaut an jede Engine. Die Abfrage unten mit drei Produkten und zwei Shopping-Prompts war nach etwa zwei Minuten fertig.

Product Lookup liest die Produkteinträge jeder Antwort und die Händler und Preise, die ChatGPT in seine Shoppingkarten schreibt, und behält die, deren Titel den Produktnamen trägt. match.score zeigt, wie viel des Namens ein Eintrag enthält, und Sets, Minis und Nachfüllpackungen sind als variant markiert. Jede Abfrage liest Live-Antworten: Preis, Bewertung und Rezensionen eines Eintrags bleiben von Lauf zu Lauf gleich, die Auswahl der Händler, die eine Engine zeigt, wechselt von Antwort zu Antwort. Vergleichen Sie daher wiederholte Abfragen, um einen Trend zu verfolgen.

Einsatzbereiche

  • Prüfen Sie, welche Engines Ihr Produkt zeigen und mit welchen Händlern und Preisen.
  • Stellen Sie Ihre Rezensionen und Preise auf jeder Engine neben die der Konkurrenz. In der Abfrage unten zeigte Bing Copilot 2.942 Rezensionen für belif, 85.773 für Clinique und 117.193 für CeraVe.
  • Stellen Sie die Kategoriefragen, die Käufer nutzen, und sehen Sie, welche Produkte die Antworten nach vorn stellen. In der Abfrage unten erschien CeraVe in 5 der 8 Antworten, belif in 2.
  • Fragen Sie vor und nach einer Änderung an Produktfeed oder Einträgen ab und vergleichen Sie, was jede Engine zeigt.

Anfrage senden

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

curl -X POST https://api.querying.ai/v1/product-lookup \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "belif Moisturizing Eye Bomb",
    "country": "US",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "idempotencyKey": "eye-bomb-us"
  }'

Felder der Anfrage

productstringPflicht
Der Produktname, wie Käufer danach suchen, 1 bis 200 Zeichen. Eine Produktseiten-URL oder ein Barcode ergibt VALIDATION_ERROR.
countrystringPflicht
US oder KR. Der Markt bestimmt die Engines und den Wortlaut der Fragen.
competitorsarray
Bis zu 5 Namen von Konkurrenzprodukten. Jedes bekommt dieselben Fragen wie Ihr Produkt.
promptsarray
Bis zu 3 Shopping-Prompts wie best eye cream for puffiness, die im Wortlaut an jede Engine gehen.
enginesarray
Abgefragte Engines. Standard in US: CHATGPT, GOOGLE, AIMODE und BING_COPILOT, in KR: NAVER_AI_TAB, CHATGPT und AIMODE. Mit GEMINI wird zusätzlich Gemini gefragt.
idempotencyKeystring
Benennt die Abfrage. Ein erneutes Senden liefert dieselbe Abfrage und ergänzt nur die fehlenden Fragen.
webhook.urlstring
Eine HTTPS-Adresse Ihres Servers. Die Aufgabe jeder Frage wird dorthin gesendet, sobald sie abgeschlossen ist.

Antwort

Die Antwort, für die Lesbarkeit gekürzt.

JSON
{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
  },
  "summary": { "total": 23, "succeeded": 23, "failed": 0 },
  "credits": { "creditsToCharge": 40, "creditsCharged": 0 },
  "asks": [
    {
      "engine": "CHATGPT",
      "taskType": "CHATGPT",
      "role": "product",
      "prompt": "Buy belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    {
      "engine": "GOOGLE",
      "taskType": "GOOGLE",
      "role": "product",
      "query": "belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "0d6d6839-8705-44c1-ac3c-c5f56cb25d08",
        "taskType": "GOOGLE",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.472Z",
        "idempotencyKey": "eye-bomb-us:GOOGLE:name"
      }
    },
    "…"
  ]
}
lookup.idstring
Die ID der Abfrage: Ihr idempotencyKey oder eine vom Server erzeugte ID. Lesen Sie die Abfrage mit GET /v1/product-lookup/{id}.
summaryobject
Zählung der Fragen: total, succeeded und failed.
credits.creditsToChargenumber
Was die Fragen kosten, sobald alle beantwortet sind: 10 Credits pro Produkt und 5 pro Shopping-Prompt.
asksarray
Ein Eintrag pro Frage: die Engine, der gestellte Text und ihre task, oder error mit Code, wenn die Frage abgelehnt wurde.

Ergebnis abholen

Jede Frage läuft als eigene Aufgabe, daher füllt sich die Abfrage, sobald Antworten eintreffen. Lesen Sie sie mit GET /v1/product-lookup/{id}, bis lookup.status COMPLETED ist, oder fügen Sie webhook.url hinzu, um die fertige Aufgabe jeder Frage zu erhalten. Eine Abfrage bleibt 24 Stunden nach dem Ende ihrer Fragen lesbar.

curl "https://api.querying.ai/v1/product-lookup/$LOOKUP_ID" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

So sieht eine fertige Abfrage aus, gekürzt.

JSON
{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "status": "COMPLETED",
    "createdAt": "2026-10-20T09:22:43.422Z",
    "completedAt": "2026-10-20T09:24:36.695Z",
    "credits": 40
  },
  "summary": {
    "foundIn": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"],
    "notFoundIn": [],
    "merchants": [
      {
        "merchant": "Ulta Beauty",
        "engines": ["CHATGPT", "BING_COPILOT"],
        "price": { "currency": "USD", "min": 48, "max": 48 }
      },
      {
        "merchant": "Amazon",
        "engines": ["CHATGPT"],
        "price": { "currency": "USD", "min": 43, "max": 43 }
      },
      "…"
    ],
    "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
    "citedDomains": [
      {
        "domain": "ulta.com",
        "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
      },
      "…"
    ],
    "credits": 10
  },
  "engines": [
    {
      "engine": "CHATGPT",
      "status": "COMPLETED",
      "found": true,
      "via": [
        {
          "taskType": "CHATGPT",
          "prompt": "Buy belif Moisturizing Eye Bomb",
          "taskId": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
          "status": "COMPLETED",
          "credits": 2
        },
        "…"
      ],
      "listings": [
        {
          "ask": 1,
          "position": 1,
          "title": "belif Moisturizing Eye Bomb Eye Cream",
          "merchant": "Ulta Beauty",
          "source": "merchant_feed",
          "price": { "value": 48, "currency": "USD", "raw": "$48.00" },
          "available": true,
          "modelSees": {
            "rating": 4.5,
            "reviewCount": 105,
            "brand": "belif"
          },
          "match": { "score": 1 }
        },
        {
          "ask": 2,
          "position": 1,
          "title": "Amazon",
          "merchant": "Amazon",
          "source": "chatgpt_widget",
          "price": { "value": 43, "currency": "USD", "raw": "$43.00" },
          "match": { "score": 1 }
        },
        "…"
      ],
      "citedPages": [
        {
          "ask": 1,
          "domain": "lgbeauty.com",
          "title": "Moisturizing Eye Bomb"
        },
        "…"
      ]
    },
    "…"
  ],
  "comparison": [
    {
      "product": "belif Moisturizing Eye Bomb",
      "role": "product",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 5,
          "mostReviewed": {
            "reviewCount": 2942,
            "rating": 4.58,
            "merchant": "Comparor"
          },
          "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
          "prompts": { "answered": 2, "appeared": 1 }
        },
        "…"
      ]
    },
    {
      "product": "CeraVe Eye Repair Cream",
      "role": "competitor",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 6,
          "mostReviewed": {
            "reviewCount": 117193,
            "rating": 4.35,
            "merchant": "Pasteur Pharmacy"
          },
          "priceRange": { "currency": "USD", "min": 15.95, "max": 38.95 },
          "prompts": { "answered": 2, "appeared": 0 }
        },
        "…"
      ]
    },
    "…"
  ],
  "prompts": [
    {
      "prompt": "best moisturizing eye cream",
      "engines": [
        {
          "engine": "GOOGLE",
          "status": "COMPLETED",
          "shown": ["CeraVe Eye Repair Cream", "Clinique All About Eyes"],
          "named": [
            "belif Moisturizing Eye Bomb",
            "CeraVe Eye Repair Cream",
            "Clinique All About Eyes"
          ]
        },
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "shown": ["belif Moisturizing Eye Bomb"],
          "named": ["belif Moisturizing Eye Bomb"]
        },
        "…"
      ]
    },
    "…"
  ]
}
lookup.statusstring
QUEUED und PROCESSING, solange Fragen laufen, COMPLETED, wenn alle beendet sind und mindestens eine beantwortet wurde, FAILED, wenn alle fehlschlugen.
lookup.creditsnumber
Bisher berechnete Credits für die beantworteten Fragen.
engines[].foundboolean
Ob die Antworten der Engine das Produkt zeigten: Ein Händlereintrag oder eine ChatGPT-Shoppingkarte genügt für true.
engines[].listingsarray
Jeder Händlereintrag, der das Produkt zeigte: merchant, price, available, Bewertung und Rezensionen, der Herkunftskatalog (source) und bei ChatGPT, was das antwortende Modell erhielt (modelSees).
summary.merchantsarray
Jeder Händler, der das Produkt zeigte, mit den Engines, die ihn zeigten, und seiner Preisspanne.
comparisonarray
Ihr Produkt und jedes Konkurrenzprodukt nebeneinander auf jeder Engine: found, listings, merchants, mostReviewed, priceRange und in wie vielen Antworten auf Shopping-Prompts es vorkam.
prompts[].enginesarray
Für jeden Shopping-Prompt und jede Engine die Produkte Ihrer Abfrage, die die Antwort zeigte (shown) und im Text nannte (named).

Fehler

VALIDATION_ERRORHTTP 400
Ein Feld fehlt oder liegt außerhalb des erlaubten Bereichs. details nennt das Feld.
REGION_UNSUPPORTEDHTTP 422
country ist ein anderer Markt als US und KR.
RESOURCE_ALREADY_EXISTSHTTP 409
Dieser idempotencyKey benennt bereits eine Abfrage zu einem anderen Produkt, Konkurrenzprodukt, Prompt oder Land. Senden Sie die Anfrage mit einem neuen Schlüssel.
INSUFFICIENT_CREDITSHTTP 402
Das Guthaben liegt unter dem Preis der Aufgabe. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.
PLAN_CONCURRENCY_LIMITHTTP 429
Die gleichzeitigen Aufgaben Ihres Tarifs sind ausgeschöpft. Die Fragen, die passen, gehen hinein, die übrigen kommen mit diesem Code in asks[] zurück, und dieselbe Anfrage nach Retry-After Sekunden ergänzt sie. Passt keine, liefert die ganze Anfrage 429.

Preis

Jedes Produkt, Ihr eigenes und jedes Konkurrenzprodukt, kostet 10 Credits und jeder Shopping-Prompt 5 Credits, gleich welche Engines Sie fragen. Der Preis verteilt sich auf die Fragen dieses Produkts, und berechnet werden nur die beantworteten Fragen. Die Abfrage oben mit drei Produkten und zwei Shopping-Prompts kostet 40 Credits.

Weitere Updates

Auf dem Laufenden bleiben

Erhalte Produktneuigkeiten per E-Mail.

RSS-Feed