Walmart Recherche API
Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response.
Tarifs et fournisseurs
Tarifs de l’API Walmart Recherche : une API, 2 fournisseurs interchangeables
Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.
Essayer
Obtenez Walmart Recherche en une requête
{
"data": {
"items": [
{
"availability": "example",
"brand": "Acme Inc",
"currency": "USD",
"image": "https://example.com/image.jpg",
"inStock": true,
"isSponsored": true,
"itemId": "a1b2c3d4",
"listPrice": 19.99,
"position": 1,
"price": 19.99,
"rating": 4.6,
"reviewsCount": 12500,
"sellerId": "a1b2c3d4",
"sellerName": "Example title",
"title": "Example title",
"url": "https://example.com/page"
}
],
"totalPages": 12500,
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet endpoint.
- querystring
airpods
Search keywords, e.g. "airpods" or "paper towels".
- facetstring
Optional Walmart facet filter token, e.g. brand:HP to keep only HP products.
- maxPricenumber
Optional maximum product price in USD.
- minPricenumber
Optional minimum product price in USD.
- pageinteger
1-based results page of about 40 to 60 products; Walmart serves no products past page 10. Each page is billed as one request. Walmart re-ranks between requests, so consecutive pages can repeat a product: deduplicate on itemId.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `totalPages`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- sortenum
best_seller
Result sort order; omit for Walmart's Best Match (e.g. price_low sorts by lowest price first).
Réponse
JSON, une valeur d’exemple par champ.
Matching Walmart product records for the requested page. Populated whenever the provider has data for the entity.
- availabilitystring
Stock status as Walmart reports it, e.g. "IN_STOCK" or "OUT_OF_STOCK".
- brandstring
Brand name, or null when Walmart omits it from the search grid (it publishes brand on clothing-style grids and on no row elsewhere; the Walmart Product SKU always carries it).
- currencystring
Price currency code, e.g. "USD"; empty when no price is shown.
- imagestring
Primary product image URL. Populated whenever the provider has data for the entity.
- inStockboolean
True when the product is in stock, false when it is not, or null when not reported.
- isSponsoredboolean
True when the result is a sponsored placement.
- itemIdstring
Walmart US item id (usItemId), the number in a walmart.com/ip/ URL; use the product URL with the Walmart Product or Walmart Reviews SKU. Populated whenever the provider has data for the entity.
- listPricenumber
Pre-discount "was" price when the product is on sale, or null when it is not discounted.
- positioninteger
1-based position of the result in this page.
- pricenumber
Current price in USD as a number, or null when the result shows no current price. Populated whenever the provider has data for the entity.
- ratingnumber
Average customer rating, 0-5, or null when the product is unrated.
- reviewsCountinteger
Number of customer ratings, or null when the product has none.
- sellerIdstring
Identifier of the seller fulfilling the shown offer.
- sellerNamestring
Name of the seller fulfilling the shown offer.
- titlestring
Product title. Populated whenever the provider has data for the entity.
- urlstring
Walmart product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
Search result wrapper, or null when nothing matched.
- totalPagesintegerpeut exiger
Highest page number available for the query; request pages 1 through this value. Absent or null when the serving source does not report it.
- totalResultsinteger
Total number of matching products Walmart reports for the query, or null when not reported.
- foundboolean
True when the search returned at least one product.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
À propos de l’API Walmart Recherche
L’API Walmart Recherche d’AnyAPI renvoie des données Walmart en JSON normalisé à partir d’un appel POST à /v1/run/walmart.search. Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response. AnyAPI route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,90 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,7% des appels Walmart Recherche passés par AnyAPI ont réussi, avec un temps de réponse médian de 3,4 secondes, sur 2 063 appels mesurés.