Walmart Product Search API
Search Walmart's catalogue by keyword and read prices, ratings and sellers for every result.
GET /v1/walmart/search1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/walmart/search?query=air%20fryer returns products, about 40 a page, each with id, name, url, imageUrl, price, wasPrice, unitPriceText, rating, reviewCount, sellerName, availability and badges. Paid placements come apart in sponsoredProducts, and relatedSearches lists the searches the site suggests.
Order with sort (relevance, bestselling, top_rated, newest, price_high_to_low, price_low_to_high) and follow page.nextCursor while page.hasMore is true. Walmart serves the first 400 or so results of a search: totalResults counts every match and page.truncated is true when the list stops before its end.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Walmart Product Search API FAQ
Why are sponsored products separate?
Walmart repeats paid placements on every page, so they come apart in sponsoredProducts and products holds the ranked results.
Can a product show up twice, or be missed, across pages?
Walmart ranks every request afresh, so products move between pages while you walk a search. The cursor remembers the products earlier pages returned and leaves out a repeat. A product that moves up onto a page you already read can be missed. Walking lego over nine pages, 69 of 360 rows were repeats left out, so expect a walk to miss some products too.
How deep can I page?
About ten pages, the depth Walmart serves. The last page reports page.truncated: true when more products match than any page can reach.
How many searches can I run?
Walmart guards its search pages more closely than its product and category pages, so search runs at a low rate: about eight pages a minute, shared by every caller. Searches sent together wait their turn, so a few at once are served one after another. One that cannot be served within the request's time answers 503 temporarily_unavailable, saying search is rate-limited, and is not charged; retry after the seconds in its Retry-After header. For steady volume, list a category's products instead, which has no such limit.
Is a search with no match an error?
No. It returns lookupStatus: found with an empty products list and totalResults: 0. The loosely related products Walmart offers instead are left out.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.