Walmart Search 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.
Pricing and providers
Walmart Search API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Walmart search in one request
{
"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"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-21 · uptime and latency measured over 30d
Request body
JSON, posted to this 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).
Response
JSON, one example value per field.
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.
- totalPagesintegercan require
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
About the Walmart Search API
The AnyAPI Walmart Search API returns Walmart search data as normalized JSON from one POST call to /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 routes each request across 2 sources and falls back automatically when one fails. It costs from $0.90 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.7% of Walmart search calls through AnyAPI succeeded, with a median response time of 3.4 seconds across 2,063 measured calls.