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

# Walmart API

> Durchsuchen Sie den Shop Walmart und lesen Sie seine Produktseiten als JSON: Rangfolge mit Preisen, Bewertungen und Bewertungsanzahl aus der Suche und Preis, Verfügbarkeit, Händler, Bilder, technische Daten und Optionen von jeder Produktseite.

Durchsuchen Sie den Shop Walmart (walmart.com) und lesen Sie seine Produktseiten über die asynchrone Task-API. Senden Sie `COMMERCE_SERP` mit `site` `walmart`, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten, oder `COMMERCE_PRODUCT` mit der `url` eines Produkts, um dieses Produkt zu lesen. Eine abgeschlossene Suche oder Produktseite 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": "walmart", "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. `walmart`.
* `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": "walmart",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "19988265343",
      "title": "Wireless Earbuds, 40Hour Battery Life, IPX6 Water Resistance, Touch Controls, for Cycling, Running and Working Out",
      "url": "https://www.walmart.com/ip/Wireless-Earbuds-40-Hour-Battery-Life-IPX6-Water-Resistance-Touch-Controls-for-Cycling-Running-and-Working-Out/19988265343",
      "price": 23.28,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 60,
      "imageUrl": "https://i5.walmartimages.com/seo/Wireless-Earbuds-40-Hour-Battery-Life-IPX6-Water-Resistance-Touch-Controls-for-Cycling-Running-and-Working-Out_9d00bfbd-1199-482e-8683-26c939d8a25e.a140f5c2f33ebe4c9d64552b6d7c8f7b.jpeg"
    },
    {
      "rank": 2,
      "productId": "20857668382",
      "title": "Bloydek Wireless Earbuds In-Ear Earbuds,Bluetooth 5.4,Strong Noise Cancellation,IPX5 Waterproof,Touch Control,Type-C Fast Charge,Gaming Low Latency",
      "url": "https://www.walmart.com/ip/Bloydek-Wireless-Bluetooth-In-Ear-Earbuds-Bluetooth-5-4-Strong-Noise-Cancellation-IPX5-Waterproof-Touch-Control-Type-C-Fast-Charge-Gaming-Low-Latency/20857668382",
      "price": 16.99,
      "currency": "USD",
      "rating": 5,
      "reviewCount": 81,
      "imageUrl": "https://i5.walmartimages.com/seo/Bloydek-Wireless-Bluetooth-In-Ear-Earbuds-Bluetooth-5-4-Strong-Noise-Cancellation-IPX5-Waterproof-Touch-Control-Type-C-Fast-Charge-Gaming-Low-Latency_30bb2f49-e592-45bf-ba5e-df79256d9612.d5a461ed3464c2970b69385668a19f3a.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF"
    },
    {
      "rank": 3,
      "productId": "7678011381",
      "title": "Clip on Earbuds Open Ear Wireless Bluetooth 5.4 Headphones with Mic,50H Play,Noise Cancelling,Waterproof,Sports Ear Buds,Lightweight Open Ear Headphones with C-Shaped Bridge,Workouts (Black)",
      "url": "https://www.walmart.com/ip/Clip-Earbuds-Open-Ear-Wireless-Bluetooth-5-4-Headphones-Mic-50H-Play-Noise-Cancelling-Waterproof-Sports-Ear-Buds-Lightweight-Open-Ear-Headphones-C-Sh/7678011381",
      "price": 13.99,
      "currency": "USD",
      "rating": 4.2,
      "reviewCount": 238,
      "imageUrl": "https://i5.walmartimages.com/seo/Clip-Earbuds-Open-Ear-Wireless-Bluetooth-5-4-Headphones-Mic-50H-Play-Noise-Cancelling-Waterproof-Sports-Ear-Buds-Lightweight-Open-Ear-Headphones-C-Sh_3f7e97de-8440-4292-b33e-1aa08be84400.a047bf99a987ed55f7c32d597934768d.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF"
    }
  ]
}
```

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

## Produktseite

```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.walmart.com/ip/Wireless-Earbuds-40-Hour-Battery-Life-IPX6-Water-Resistance-Touch-Controls-for-Cycling-Running-and-Working-Out/19988265343" } }'
```

### Parameter

* `url`: Erforderlich. Eine Produktseite im Shop Walmart, höchstens 2.048 Zeichen: `walmart.com/ip/{name}/{id}`. Produkt-`url` aus einer Suche funktionieren unverändert. Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt.
* `country`: Optional. Standard ist `US`, das Land der Seite. 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": "walmart",
  "country": "US",
  "url": "https://www.walmart.com/ip/Wireless-Earbuds-40-Hour-Battery-Life-IPX6-Water-Resistance-Touch-Controls-for-Cycling-Running-and-Working-Out/19988265343",
  "productId": "19988265343",
  "title": "Wireless Earbuds, 40‑Hour Battery Life, IPX6 Water Resistance, Touch Controls, for Cycling, Running and Working Out",
  "brand": "Rovisigns",
  "price": 23.28,
  "listPrice": 39.99,
  "currency": "USD",
  "inStock": true,
  "seller": "DEYU",
  "rating": 4.6,
  "reviewCount": 60,
  "images": [
    "https://i5.walmartimages.com/seo/Wireless-Earbuds-40-Hour-Battery-Life-IPX6-Water-Resistance-Touch-Controls-for-Cycling-Running-and-Working-Out_9d00bfbd-1199-482e-8683-26c939d8a25e.a140f5c2f33ebe4c9d64552b6d7c8f7b.jpeg",
    "https://i5.walmartimages.com/asr/13c98513-e5c4-4247-9a11-5cdef37188ce.afb045dc15d75519e29ab72440ca2968.jpeg"
  ],
  "description": "Immersive Rich Audio & Clear Calls：Our open-ear earbuds Adopts innovative quad-speaker structure with dual drivers per earbud, equipped with 15mm large-diaphragm dynamic drivers and dedicated…",
  "specs": [
    { "name": "Battery life", "value": "60 h" },
    { "name": "Headphone style", "value": "In-Ear" },
    { "name": "Noise control technology", "value": "Passive Noise Cancellation" }
  ],
  "categories": [
    "Electronics",
    "Audio",
    "Headphones",
    "Shop Headphones by Type",
    "Earbuds and In-Ear Headphones"
  ],
  "gtin": "607616049364"
}
```

### Ergebnisfelder

* `site`, `country`, `url` und `productId` kennzeichnen die Seite. `url` ist die gelesene Seite, und `productId` entspricht der ID aus einer Suche.
* `title` ist immer vorhanden. `brand`, `price`, `listPrice`, `currency`, `inStock`, `seller`, `rating`, `reviewCount`, `images`, `description`, `specs`, `options`, `categories` und `gtin` erscheinen, wenn die Seite sie zeigt.
* `price` ist, was ein Käufer laut der Seite beim Öffnen zahlt, vor Gutscheinen und Versand, in `currency` (ISO 4217). `listPrice` ist der reguläre Preis, den die Seite durchstreicht, vorhanden, wenn er über `price` liegt. `inStock` ist die Verfügbarkeit des Produkts. `seller` ist der Händler, der es verkauft.
* `rating` nutzt eine Fünf-Punkte-Skala mit zwei Nachkommastellen. `reviewCount` ist die Anzahl der Bewertungen.
* `images` listet bis zu 30 Fotos aus der Produktgalerie in Seitenreihenfolge.
* `description` ist reiner Text mit einer Zeile pro Absatz, bis zu 10.000 Zeichen; Text, der nur in Bildern steht, ist nicht enthalten.
* `specs` listet bis zu 100 Paare `{ name, value }` aus den Produktdetails. `options` listet bis zu 20 Auswahlmöglichkeiten wie Größe oder Farbe, jede mit bis zu 100 `values`; die übrigen Felder beschreiben die Auswahl, mit der die Seite öffnet. `categories` reicht von der breitesten bis zur engsten Kategorie, bis zu 10 Ebenen. `gtin` ist die UPC, EAN oder JAN, die die Seite angibt.

## Fehler und Abrechnung

* Eine Suche ohne Produkte endet als fehlgeschlagener Task.
* Eine Produktseite, 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. Lehnt der Shop den Lesevorgang mit 403, 412, 429 oder 435 ab, wartet der Task und fragt bis zu 6 Minuten lang erneut. Andere fehlgeschlagene Lesevorgänge und eine länger andauernde Ablehnung enden mit `ENGINE_NO_RESULT`.
* Abgerechnet werden nur abgeschlossene Tasks: 0.5 Credits pro Suche oder Produktseite.

## Siehe auch

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