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.

Was Sie erhalten

• COMMERCE_PRODUCT: Jede Aufgabe liest eine Produktseite aus 17 Shops in den USA, Korea, Japan, Indien und Deutschland. Übergeben Sie die url der Seite; sie bestimmt den Shop.
• title, brand, price und listPrice mit ihrer currency, inStock, seller, rating und reviewCount, so wie die Seite sie zeigt.
• images: die Produktgalerie. descriptionImages: die Bilder der Produktbeschreibung, etwa die Detailseite des Händlers oder Amazons A+-Inhalte, in der Reihenfolge der Seite.
• description, specs, options, categories und gtin in denselben Feldern für jeden Shop.

Shops

• USA (US): Amazon amazon, Walmart walmart, Target target, Sephora sephora, Ulta ulta
• Korea (KR): 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 Produktseite aus dem Land des Shops und gibt die Werte der Auswahl zurück, mit der sich die Seite öffnet. price ist, was Käufer vor Gutscheinen und Versand zahlen, und options listet die übrigen Größen, Farben oder Sets.

images enthält bis zu 30 Fotos aus der Galerie und descriptionImages bis zu 300 Bilder aus der Beschreibung, in der Reihenfolge der Seite. Beschreibungsbilder kommen von Amazon, Ulta, Olive Young, 11st, Lotte ON, Musinsa, Kurly, Rakuten, Yahoo! Shopping und Qoo10. Banner und Hinweise, die Händler dort platzieren, kommen mit, und Text in einem Bild bleibt Teil des Bildes.

title, price, currency und images kommen von jedem Shop; die übrigen Felder kommen, wenn die Seite sie zeigt, und die Engine-Dokumentation nennt die Shops für jedes Feld. Meldet der Shop eine entfernte Seite, etwa ein ausgelistetes Produkt, endet die Aufgabe mit PAGE_UNAVAILABLE.

Einsatzbereiche

• Lesen Sie die vorderen Produkte einer Commerce Search vollständig: Preis, Bestand, Händler und alle Optionen.
• Verfolgen Sie täglich Preis, Listenpreis und Bestand Ihrer Produktseite bei Amazon, Olive Young und Rakuten.
• Sammeln Sie Galerie- und Detailbilder der Konkurrenz, um zu vergleichen, wie jede Marke dasselbe Produkt präsentiert.
• Übernehmen Sie technische Daten, Optionen und Beschreibungsbilder in Ihren Katalog oder in eine Prüfung von KI-Shopping-Antworten.

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_PRODUCT",
    "payload": { "url": "https://www.amazon.com/dp/B00TTD9BRC" }
  }'

Felder der Anfrage

taskTypestringPflicht

Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.

payload.urlstringPflicht

Eine Produktseite eines der 17 Shops, bis zu 2.048 Zeichen. Die URL legt den Shop und sein Land fest.

payload.countrystring

Das Land des Shops, etwa US für Amazon oder KR für Olive Young. Es ist auch der Standardwert.

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": "3f0f65f4-bb08-492b-8652-7037fe7cba0d",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T09:27:29.765Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "amazon",
    "country": "US",
    "url": "https://www.amazon.com/dp/B00TTD9BRC",
    "productId": "B00TTD9BRC",
    "title": "CeraVe Moisturizing Cream, Face & Body Moisturizer for Dry Skin, 19oz",
    "brand": "CeraVe",
    "price": 18.39,
    "currency": "USD",
    "inStock": true,
    "seller": "Amazon.com",
    "rating": 4.7,
    "reviewCount": 149176,
    "images": [
      "https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg",
      "https://m.media-amazon.com/images/I/61-Ut3jOyyL._SL1500_.jpg",
      "…"
    ],
    "descriptionImages": [
      "https://m.media-amazon.com/images/S/aplus-media-library-service-media/8c56d081-e316-4b57-9731-fcf4eda0821f.__CR0,0,1464,600_PT0_SX1464_V1___.jpg",
      "…"
    ],
    "specs": [
      { "name": "Brand Name", "value": "CeraVe" },
      { "name": "Skin Type", "value": "All, Dry, Sensitive" },
      "…"
    ],
    "options": [
      {
        "name": "Size",
        "values": [
          "8 Ounce",
          "16 Ounce (Pack of 1)",
          "19 Ounce (Pack of 1)",
          "…"
        ]
      }
    ],
    "categories": ["Beauty & Personal Care", "Skin Care", "Face", "…"]
  }
}

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.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.imagesarray

Bis zu 30 Fotos aus der Produktgalerie, in der Reihenfolge der Seite.

response.descriptionImagesarray

Bis zu 300 Bilder aus der Produktbeschreibung, etwa die Detailseite des Händlers oder Amazons A+-Inhalte, in der Reihenfolge der Seite.

response.specsarray

Bis zu 100 { name, value }-Paare aus den Produktdetails. options listet Auswahlmöglichkeiten wie Größe oder Farbe, jeweils mit ihren values.

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

url fehlt, ist länger als 2.048 Zeichen oder liegt außerhalb der Produktseiten der 17 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 einer Amazon-URL.

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

Jedes abgeschlossene Lesen kostet in jedem Shop 3 Credits. Die Credits werden beim Abschluss der Aufgabe abgebucht.