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

# AliExpress API

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

Durchsuchen Sie den Shop AliExpress (aliexpress.com) über die asynchrone Task-API. Senden Sie `COMMERCE_SERP` mit `site` `aliexpress`, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten. `COMMERCE_PRODUCT` liest die Produktseiten dieses Shops nicht. Eine abgeschlossene Suche kostet **0.5 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": "aliexpress", "query": "wireless earbuds", "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. `aliexpress`.
* `query`: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
* `limit`: Optionale Ganzzahl von 1 bis 40, Standard 20.
* `country`: Optional. Standard ist `US`, 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`.

### Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "site": "aliexpress",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "3256813273775472",
      "title": "Wireless Earbuds, Bluetooth 5.4 Earbuds Stereo Bass, Bluetooth Headphones in Ear Noise Cancelling Mic, Earphones IP7 Waterproof Sports, 36H Playtime USB C Mini Charging Case Ear Buds for Android iOS",
      "url": "https://www.aliexpress.com/item/3256813273775472.html",
      "price": 13.95,
      "currency": "USD",
      "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/Seafc726f8c6247c48e492e80361dbb0ah.jpg"
    },
    {
      "rank": 2,
      "productId": "3256811621288203",
      "title": "2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily Use, For IPhone IOS Smartphone, Gaming /Sports /Fitness Earphones.",
      "url": "https://www.aliexpress.com/item/3256811621288203.html",
      "price": 13.25,
      "currency": "USD",
      "rating": 4.9,
      "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/Sa57a4580c1274b01988d5df3fa8e76cbx.jpg"
    },
    {
      "rank": 3,
      "productId": "3256813271161904",
      "title": "Smart Touch Control True Wireless Earbuds, Active Noise Cancelling, Portable Mini Charging Case Easy To Carry, Low Latency For Gaming, Long Battery Life, Instant Connection, Spatial Audio, Ergonomic In-Ear Comfort Fit, Air Bluetooth Headphones.",
      "url": "https://www.aliexpress.com/item/3256813271161904.html",
      "price": 27.39,
      "currency": "USD",
      "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S9675a1dc8aa545959180535f79ea4ddd2.jpg"
    }
  ]
}
```

### 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, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen.
* `price`, `rating` 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. Die Preise von AliExpress sind die Angebotspreise, die ein nicht angemeldeter Käufer in den USA sieht.
* `rating` nutzt eine Fünf-Punkte-Skala. AliExpress zeigt Sterne ohne Anzahl der Bewertungen, daher haben seine Produkte kein `reviewCount`.
* 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 0.5 Credits.

## Siehe auch

* [Amazon](https://docs.querying.ai/de/engines/amazon.md)
* [Walmart](https://docs.querying.ai/de/engines/walmart.md)
* [Target](https://docs.querying.ai/de/engines/target.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.