Die Produktsuche in 20 Onlineshops wird jetzt unterstützt

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.

Was Sie erhalten

• COMMERCE_SERP: Jede Aufgabe durchsucht einen Shop, gewählt mit payload.site, aus 20 Shops in den USA, Korea, Japan, Indien und Deutschland.
• products: das Ranking des Shops für Ihre Suche, bis zu 40 Produkte, jeweils mit rank, productId, title und url.
• price als Zahl mit der zugehörigen currency, dazu rating, reviewCount, brand und imageUrl, sobald die Ergebnisseite sie zeigt.
• Dieselben Produktfelder in jedem Shop, sodass ein Parser Amazon, Coupang, Rakuten und Zalando gleich liest.

Shops

• USA (US): Amazon amazon, Walmart walmart, Target target, eBay ebay, AliExpress aliexpress, Sephora sephora, Ulta ulta
• Korea (KR): Coupang coupang, Olive Young oliveyoung, 11st 11st, Lotte ON lotteon, Musinsa musinsa, Kurly kurly
• Japan (JP): Rakuten rakuten, Yahoo! Shopping yahoo_shopping, Qoo10 qoo10
• Indien (IN): Flipkart flipkart, Myntra myntra, Nykaa nykaa
• Deutschland (DE): Zalando zalando

So funktioniert es

Jede Aufgabe liest die erste Ergebnisseite, die der Shop in seinem eigenen Land für Ihre Suche zeigt, und gibt die Produkte in der Standardreihenfolge des Shops zurück. In allen Shops außer Coupang werden als gesponsert markierte Angebote herausgenommen, und rank zählt die übrigen in der Reihenfolge der Seite.

productId ist die eigene ID des Shops: die ASIN bei Amazon, die Artikelnummer bei eBay, shop:item bei Rakuten. price ist eine Zahl in der currency des Produkts (ISO 4217) und bei unterschiedlich bepreisten Größen der niedrigste Preis. rating nutzt eine Fünf-Punkte-Skala in den Shops, die Bewertungen zeigen; Kurly und Zalando führen Produkte mit Preis und Titel.

Leitet ein Shop eine Suche auf eine andere Seite, stammen die Produkte von dieser Seite: Ulta leitet manche Markennamen auf die Markenseite, Target leitet manche Suchen auf eine verwandte Suche, und Nykaa zeigt für Suchen nach einer Kategorie die Kategorieseite. Eine Suche ohne gefundene Produkte endet als fehlgeschlagene Aufgabe.

Einsatzbereiche

• Verfolgen Sie täglich, auf welchem Platz Ihr Produkt bei der Kategoriesuche auf Amazon, Walmart und Target steht.
• Vergleichen Sie Ihren Preis, Ihre Bewertung und Ihre Rezensionszahl mit den Produkten auf den Plätzen um Sie herum.
• Begleiten Sie eine Beauty- oder Modelinie auf Olive Young, Rakuten, Nykaa und Zalando mit demselben Anfrageformat.
• Stellen Sie das Shop-Ranking neben die Antworten von ChatGPT oder Google AI Mode für dieselbe Suche und sehen Sie, welche Produkte Käufer an jedem Ort finden.

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": "target", "query": "sunscreen", "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 20 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.

{
  "success": true,
  "task": {
    "id": "fa04f93f-babe-4d50-9549-8b7100261fee",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T00:05:55.416Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "target",
    "query": "sunscreen",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "76545827",
        "title": "La Roche Posay Anthelios Melt in Milk Sunscreen Lotion - SPF 100 - 3.0 fl oz",
        "brand": "La Roche Posay",
        "url": "https://www.target.com/p/la-roche-posay-anthelios-melt-in-milk-sunscreen-lotion-spf-100-3-0-fl-oz/-/A-76545827",
        "price": 20.99,
        "currency": "USD",
        "rating": 4.54,
        "reviewCount": 995
      },
      {
        "rank": 2,
        "productId": "80839020",
        "title": "Neutrogena Beach Defense Sunscreen Lotion - SPF 70 - 1 fl oz",
        "brand": "Neutrogena",
        "url": "https://www.target.com/p/neutrogena-beach-defense-sunscreen-lotion-spf-70-1-fl-oz/-/A-80839020",
        "price": 1.99,
        "currency": "USD",
        "rating": 4.59,
        "reviewCount": 1580
      },
      "…"
    ]
  }
}

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 des Shops: rank, productId, title und url, dazu price, currency, rating, reviewCount, imageUrl und brand, wenn die Ergebnisseite 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"

Fehler

VALIDATION_ERRORHTTP 422

site liegt außerhalb der 20 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.

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 kostet in jedem Shop 3 Credits. Die Credits werden beim Abschluss der Aufgabe abgebucht.