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.
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.
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.statusCOMPLETED 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.
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.
Ü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.
Durchsuchen Sie Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando und 13 weitere Shops in fünf Ländern und erhalten Sie das Produktranking jedes Shops mit Preisen, Bewertungen und Rezensionszahlen im selben Format.