> ## 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 Search API (COMMERCE_SERP)

> Durchsuchen Sie Amazon, Walmart, eBay, AliExpress, Google Shopping, Sephora, Coupang, Olive Young, Rakuten, Flipkart, Zalando und weitere Shops, einen Shop pro Task, und erhalten Sie gerankte Produkte mit Preis, Bewertung und Rezensionszahl im selben Format.

Durchsuchen Sie die Produkte eines Shops und erhalten Sie die gerankte Liste als JSON über die asynchrone Task-API. Wählen Sie den Shop mit `site`; alle Shops liefern dieselben Produktfelder. Eine abgeschlossene Suche 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_SERP", "payload": { "site": "amazon", "query": "wireless earbuds", "limit": 20 } }'
```

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

* `site`: Erforderlich. Der zu durchsuchende Shop aus der Tabelle unten.
* `query`: Erforderlicher Suchbegriff mit 1 bis 500 Zeichen.
* `country`: Optional. Standard ist das Land des Shops. Jedes andere Land wird mit `422 REGION_UNSUPPORTED` abgelehnt.
* `limit`: Optionale Ganzzahl von 1 bis 40, Standard 20.

| `site` | Shop | `country` |
| - | - | - |
| `amazon` | amazon.com | `US` |
| `walmart` | walmart.com | `US` |
| `target` | target.com | `US` |
| `ebay` | ebay.com | `US` |
| `aliexpress` | aliexpress.com | `US` |
| `google_shopping` | shopping.google.com | `US` |
| `sephora` | sephora.com | `US` |
| `ulta` | ulta.com | `US` |
| `coupang` | coupang.com | `KR` |
| `oliveyoung` | oliveyoung.co.kr | `KR` |
| `11st` | 11st.co.kr | `KR` |
| `lotteon` | lotteon.com | `KR` |
| `musinsa` | musinsa.com | `KR` |
| `kurly` | kurly.com | `KR` |
| `rakuten` | rakuten.co.jp | `JP` |
| `yahoo_shopping` | shopping.yahoo.co.jp | `JP` |
| `qoo10` | qoo10.jp | `JP` |
| `flipkart` | flipkart.com | `IN` |
| `myntra` | myntra.com | `IN` |
| `nykaa` | nykaa.com | `IN` |
| `zalando` | zalando.de | `DE` |

## Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "site": "amazon",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 1,
  "products": [
    {
      "rank": 1,
      "productId": "B0CHWRXH8B",
      "title": "Wireless Earbuds, Bluetooth 5.3 Headphones",
      "url": "https://www.amazon.com/dp/B0CHWRXH8B",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 19406
    }
  ]
}
```

## Ergebnisfelder

* `site`, `query` und `country` geben die Anfrage wieder. `returnedCount` ist die Anzahl der Einträge in `products`.
* Jedes Produkt enthält `rank`, `productId`, `title` und `url`. `productId` ist die shopeigene Produkt-ID, etwa die ASIN bei Amazon, die Artikelnummer bei eBay oder `shop:item` bei Rakuten. `rank` folgt der Standardsortierung des Shops. Außer bei Coupang überspringt es Einträge, die der Shop als gesponsert kennzeichnet.
* `price`, `rating`, `reviewCount`, `imageUrl` und `brand` erscheinen, wenn die Ergebnisseite sie zeigt. `price` ist eine Zahl in der `currency` (ISO 4217) des jeweiligen Produkts: Eine Amazon-Suche kann mehrere Währungen zeigen. Haben Größen unterschiedliche Preise, ist `price` der niedrigste. Target-Preise sind die des Standard-Onlineshops von Target. AliExpress-Preise sind die Verkaufspreise, die ein nicht angemeldeter Käufer in den USA sieht.
* `rating` nutzt eine Fünf-Sterne-Skala. Kurly und Zalando zeigen keine Bewertungen, AliExpress zeigt Sterne ohne Anzahl der Bewertungen, und abgekürzte Zahlen wie 999+ entfallen. `brand` liefern Target, Sephora, Ulta, Olive Young, Lotte ON, Musinsa, Yahoo! Shopping, Qoo10, Flipkart, Myntra, Nykaa und Zalando, die die Marke getrennt vom Titel zeigen.
* Bei `google_shopping` ist `productId` die Produkt-ID von Google oder die Angebots-ID, wenn Google das Angebot keinem Produkt zugeordnet hat. Googles Seite verlinkt weder Produkt- noch Händlerseiten, daher ist `url` die Google-Shopping-Ergebnisseite, auf der das Produkt gelistet ist, mit `#product={productId}&title={title}` am Ende. Übergeben Sie diese `url` an [Commerce Product](/de/engines/commerce-product.md), um Shops, Spezifikationen und Beschreibung des Produkts zu lesen. `seller` ist der Shop, den Google zuerst nennt, und `reviewCount` erscheint nur, wenn Google die genaue Zahl zeigt (unter 1.000).
* Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops. Diese Seite zeigt bei Yahoo! Shopping bis zu 30 Produkte, bei Myntra 32 und bei Zalando 24. Bei Flipkart hat sie 40 Plätze und bei Nykaa 20, gesponserte Einträge eingeschlossen.
* Leitet ein Shop die Suche auf eine andere Seite um, stammen die Produkte von dieser Seite: Ulta leitet manche Markennamen auf die Markenseite um, Target manche Suchen auf eine verwandte Suche, und Nykaa zeigt für Suchen nach einer Kategorie die Kategorieseite.
* Eine Suche ohne Produkte endet als fehlgeschlagener Task. Abgerechnet wird pro abgeschlossener Suche.

## Siehe auch

* [Commerce Product](/de/engines/commerce-product.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.