Commerce Product API (COMMERCE_PRODUCT)

​

Anfrage

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" } }'

​

Parameter

• url: Erforderlich. Eine Produktseite eines der Shops unten, höchstens 2.048 Zeichen. Die Produkt-url, die Commerce Search für diese Shops liefert, funktioniert unverändert, außer LOHACO-Seiten von Yahoo! Shopping (lohaco.yahoo.co.jp). Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt.
• country: Optional. Standard ist das Land des Shops. Jedes andere Land wird mit 422 REGION_UNSUPPORTED abgelehnt.

​

Antwortbeispiel

{
  "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": 16.77,
  "listPrice": 18.96,
  "currency": "USD",
  "inStock": true,
  "seller": "Amazon.com",
  "rating": 4.7,
  "reviewCount": 149149,
  "images": ["https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg"],
  "description": "[ HYALURONIC ACID MOISTURIZER ] With hyaluronic acid, ceramides and MVE technology for 24 hour hydration.",
  "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": "Item Form", "value": "Cream" },
    { "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", "Creams & Moisturizers", "Face Moisturizers"]
}

​

Ergebnisfelder

• site, country, url und productId kennzeichnen die Seite. url ist die gelesene Seite. productId ist die eigene Produkt-ID des Shops, etwa die ASIN bei Amazon oder shop:item bei Rakuten, und stimmt mit der von Commerce Search überein. Ausnahme sind Nykaa-Produkte mit Farbtönen oder Größen: Commerce Search liefert die ID einer Variante, dieses Lesen die ID der Produktseite.
• title ist immer vorhanden. Die übrigen Felder erscheinen, wenn die Seite sie zeigt; die Tabelle unten nennt die Shops, die jedes Feld liefern.
• price ist der Preis, den ein Käufer für das Produkt so zahlt, wie die Seite es beim Öffnen zeigt, vor Gutscheinen und Versand, in currency (ISO 4217). listPrice ist der durchgestrichene reguläre Preis und erscheint, wenn er über price liegt. inStock gibt an, ob dieses Produkt vorrätig ist, und seller ist der Verkäufer.
• rating nutzt eine Fünf-Punkte-Skala mit zwei Nachkommastellen. reviewCount ist die Zahl der Bewertungen.
• images enthält bis zu 30 Fotos aus der Bildergalerie des Produkts in der Reihenfolge der Seite. 11st und Lotte ON liefern nur das Hauptfoto, Sephora bis zu zwei; bei Rakuten und Yahoo! Shopping kommen auch Banner oder Hinweise mit, die der Händler in diese Galerie stellt. description ist reiner Text mit einer Zeile pro Absatz, höchstens 10.000 Zeichen; Text, der nur in Bildern steht, fehlt.
• descriptionImages enthält bis zu 300 Bilder aus der Produktbeschreibung, etwa der Detailseite des Händlers oder dem A+-Inhalt von Amazon, in der Reihenfolge der Seite. Banner und Hinweise, die der Händler in seine Beschreibung stellt, kommen mit; Text in den Bildern wird nicht gelesen.
• specs enthält bis zu 100 Paare { name, value } aus den Produktdetails. options enthält bis zu 20 Auswahlmöglichkeiten wie Größe oder Farbe mit jeweils bis zu 100 values; die übrigen Felder beschreiben die Auswahl, mit der die Seite öffnet. categories reicht von der breitesten zur engsten Kategorie, höchstens 10 Ebenen. gtin ist die auf der Seite angegebene UPC, EAN oder JAN.
• google_shopping liest ein Produkt, das Commerce Search zurückgegeben hat: Seine url enthält die Suchanfrage, Googles Produkt-ID und den Produkttitel. Der Lesevorgang führt die Suche in Google Shopping erneut aus, sucht nach dem Titel, wenn Google das Produkt für die Suchanfrage nicht mehr listet, und öffnet das Produktfenster, daher dauert er länger als eine Shop-Seite. offers listet die Shops, die Google für das Produkt zeigt, beginnend mit dem Shop, den Google als besten Preis markiert, jeweils mit seller, title (Produktname des Shops), url (Produktseite des Shops), price, listPrice, currency und inStock. price, listPrice, seller und inStock des Produkts stammen vom ersten Shop. reviewCount erscheint nur, wenn Google die genaue Zahl zeigt (unter 1.000). Listet Google das Produkt für keine der beiden Suchen, endet der Task mit PAGE_UNAVAILABLE.
• Eine Seite, die der Shop mit 404 oder 410 beantwortet, etwa ein entferntes Produkt, beendet den Task mit PAGE_UNAVAILABLE, und die Meldung enthält die Antwort des Shops. Andere fehlgeschlagene Lesevorgänge enden mit ENGINE_NO_RESULT. Abgerechnet wird jeder abgeschlossene Lesevorgang.

​

Siehe auch

• Commerce Search
• Engine-Übersicht
• Credits und Limits