> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Commerce Product API (COMMERCE_PRODUCT)

> Lesen Sie eine Produktseite von Amazon, Walmart, Target, Sephora, Ulta, Olive Young, 11st, Musinsa, Kurly, Rakuten, Flipkart, Zalando und weiteren Shops und erhalten Sie Preis, Lagerstatus, Verkäufer, Bewertung, Bilder, technische Daten und Varianten in einer Form.

Lesen Sie die Produktseite eines Shops und erhalten Sie das Produkt als JSON über die asynchrone Task-API. Übergeben Sie die `url` der Seite; die URL bestimmt den Shop, und alle Shops liefern dieselben Felder. Ein abgeschlossener Lesevorgang kostet **3 Credits**.

## Anfrage

```bash theme={"theme":"css-variables"}
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" } }'
```

Senden Sie den Task und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](/de/concepts/async-tasks.md).

## Parameter

* `url`: Erforderlich. Eine Produktseite eines der Shops unten, höchstens 2.048 Zeichen. Die Produkt-`url`, die [Commerce Search](/de/engines/commerce-serp.md) 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.

| `site` | Produktseite | `country` |
| - | - | - |
| `amazon` | `amazon.com/dp/{ASIN}` | `US` |
| `walmart` | `walmart.com/ip/{name}/{id}` | `US` |
| `target` | `target.com/p/{name}/-/A-{TCIN}` | `US` |
| `sephora` | `sephora.com/product/{name}-P{id}` | `US` |
| `ulta` | `ulta.com/p/{name}-{id}` | `US` |
| `11st` | `11st.co.kr/products/{id}` | `KR` |
| `lotteon` | `lotteon.com/p/product/{id}` | `KR` |
| `musinsa` | `musinsa.com/products/{id}` | `KR` |
| `kurly` | `kurly.com/goods/{id}` | `KR` |
| `oliveyoung` | `oliveyoung.co.kr/store/goods/getGoodsDetail.do?goodsNo={id}` | `KR` |
| `rakuten` | `item.rakuten.co.jp/{shop}/{item}/` | `JP` |
| `yahoo_shopping` | `store.shopping.yahoo.co.jp/{store}/{item}.html` | `JP` |
| `qoo10` | `qoo10.jp/g/{id}` | `JP` |
| `flipkart` | `flipkart.com/{name}/p/{itm}?pid={pid}` | `IN` |
| `myntra` | `myntra.com/{category}/{brand}/{name}/{id}/buy` | `IN` |
| `nykaa` | `nykaa.com/{name}/p/{id}` | `IN` |
| `zalando` | `zalando.de/{name}-{sku}.html` | `DE` |
| `google_shopping` | `google.com/search?q={query}&udm=28#product={productId}&title={title}` | `US` |

Andere Adressen derselben Seite funktionieren ebenfalls, etwa `/gp/product/{ASIN}` bei Amazon oder die mobilen Seiten von 11st.

## Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "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](/de/engines/commerce-serp.md) 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.

| Feld | Shops, die es liefern |
| - | - |
| `title`, `price`, `currency`, `images` | Alle |
| `brand` | Alle außer Rakuten |
| `inStock` | Alle außer Target und Sephora |
| `rating` | Alle außer Lotte ON, Kurly und Zalando |
| `reviewCount` | Alle außer Lotte ON und Zalando |
| `categories` | Alle außer Sephora, Qoo10, Flipkart und Google Shopping |
| `description` | Alle außer 11st und Qoo10. Lotte ON, Musinsa und Olive Young zeigen die Produktbeschreibung meist als Bilder, daher haben nur wenige ihrer Seiten eine. Flipkart und Zalando liefern die kurze Zusammenfassung, die sie für Suchmaschinen veröffentlichen. |
| `descriptionImages` | Amazon, Ulta, 11st, Lotte ON, Musinsa, Kurly, Olive Young, Rakuten, Yahoo! Shopping und Qoo10 |
| `specs` | Amazon, Walmart, Target, Ulta, Lotte ON, Musinsa, Kurly, Myntra, Nykaa und Google Shopping |
| `options` | Amazon, Walmart, Ulta, Musinsa, Kurly, Olive Young, Rakuten, Myntra, Nykaa und Zalando |
| `seller` | Amazon, Walmart, Lotte ON, Kurly, Rakuten, Myntra, Nykaa und Google Shopping |
| `listPrice` | Amazon, Walmart, Target, Sephora, Musinsa, Kurly, Olive Young, Qoo10, Myntra, Nykaa und Google Shopping |
| `offers` | Google Shopping |
| `gtin` | Amazon, Walmart, Target, Ulta, Olive Young, Rakuten und Yahoo! Shopping |

## Siehe auch

* [Commerce Search](/de/engines/commerce-serp.md)
* [Engine-Übersicht](/de/engines/overview.md)
* [Credits und Limits](/de/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.