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

# Coupang API

> Durchsuchen Sie den Shop Coupang als JSON: Rangfolge mit Preisen, Bewertungen und Bewertungsanzahl, in der Reihenfolge des Shops.

Durchsuchen Sie den Shop Coupang (coupang.com) über die asynchrone Task-API. Senden Sie `COMMERCE_SERP` mit `site` `coupang`, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten. `COMMERCE_PRODUCT` liest die Produktseiten dieses Shops nicht. Eine abgeschlossene Suche kostet **2 Credits**.

## Suche

```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": "coupang", "query": "airpods", "limit": 3 } }'
```

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

### Parameter

* `site`: Erforderlich. `coupang`.
* `query`: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
* `limit`: Optionale Ganzzahl von 1 bis 40, Standard 20.
* `country`: Optional. Standard ist `KR`, das Land des Shops. Jedes andere Land wird mit `422 REGION_UNSUPPORTED` abgelehnt.

Nur die oben aufgeführten Payload-Felder werden akzeptiert. Lassen Sie `include` weg: Auch `include: {}` führt vor der Credit-Reservierung zu `422 VALIDATION_ERROR` für `payload.include`.

### 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 eigene Produkt-ID des Shops. `rank` folgt der Standardreihenfolge des Shops, gesponserte Einträge eingeschlossen.
* `price`, `rating`, `reviewCount` und `imageUrl` erscheinen, wenn die Ergebnisseite sie zeigt. `price` ist eine Zahl in der `currency` des Produkts (ISO 4217); haben Größen eigene Preise, ist es der niedrigste.
* `rating` nutzt eine Fünf-Punkte-Skala. Abgekürzte Bewertungszahlen wie 999+ werden ausgelassen.
* Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops.

## Fehler und Abrechnung

* Eine Suche ohne Produkte endet als fehlgeschlagener Task.
* Abgerechnet werden nur abgeschlossene Suchen, je 2 Credits.

## Siehe auch

* [Olive Young](https://docs.querying.ai/de/engines/oliveyoung.md)
* [11st](https://docs.querying.ai/de/engines/11st.md)
* [Lotte ON](https://docs.querying.ai/de/engines/lotteon.md)
* [Alle Commerce-Shops](https://docs.querying.ai/de/engines/overview.md#commerce)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


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