Walmart search
Walmart keyword search.
Returns one page of products with price, rating, seller, availability and
whether the tile is a paid placement (is_sponsored), Walmart mixes ads
into the grid, so anyone ranking organic results needs that flag.
total_results is Walmart's catalogue count for the query and is not
how many rows you can page through. A query can be paged for roughly 500
products (~10 pages of 50) and then goes empty, however large
total_results is, measured on "coffee maker", pages 8-10 came back full
and page 11 empty against a reported 3,095 results. max_page overstates
this too, and Walmart rewrites it down to 1-2 once you overshoot, so
has_more: true means "Walmart says there is another page", not a
guarantee it holds anything. Past the end you get an empty list with
has_more: false, not an error. To reach deeper, narrow with
min_price/max_price or a facet rather than paging further.
A misspelled query silently returns results for what Walmart thinks you
meant; corrected_query is the only way to see that happened.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 8.7s.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/walmart-search-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "coffee maker" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "category_id": "0", "category_name": "coffee maker", "has_more": true, "max_page": 13, "page": 1, "products": [ { "availability": { "display": "In stock", "in_stock": true, "status": "IN_STOCK" }, "badges": [ "5K+ bought in past month" ], "category_path": "Home Page/Home/Appliances/Kitchen Appliances/Coffee Shop/Ninja Coffee Makers", "condition": 1, "flag": "5K+ bought in past month", "fulfillment_type": "STORE", "image": "https://i5.walmartimages.com/seo/Ninja-12-Cup-Stainless-Steel-Coffee-Maker-Glass-Carafe-CE250_7116f934-420c-4624-b73e-e27cdfb34bf4.e36efce32f01855336164e28a84ba916.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF", "is_preowned": false, "is_sponsored": true, "item_id": "997508948", "name": "Ninja 12-Cup Programmable Drip Coffee Maker, 2 Brew Styles, Adjustable Warming Plate, CE250, Black/Stainless Steel", "offer_id": "5ABBEA4FAF334CD38DC63AFB4FB2F517", "price": { "currency": "USD", "current_price": 64.97, "is_price_range": false, "max_price": 119.99, "min_price": 64.97, "savings": 9.03, "was_price": 74 }, "product_id": "1SJDBC3BWBUO", "rating": { "average": 4.5, "review_count": 8606 }, "seller": { "id": "F55CDC31AB754BB68FE0B39041159D63", "name": "Walmart.com" }, "url": "https://www.walmart.com/ip/Ninja-12-Cup-Programmable-Coffee-Maker-Glass-Carafe-Stainless-Steel-CE250/997508948?classType=VARIANT&athbdg=L1102" }, { "availability": { "display": "In stock", "in_stock": true, "status": "IN_STOCK" }, "badges": [ "Rollback" ], "category_path": "Home Page/Home/Appliances/Kitchen Appliances/Coffee Shop/Ninja Coffee Makers", "condition": 1, "flag": "Rollback", "fulfillment_type": "STORE", "image": "https://i5.walmartimages.com/seo/Ninja-Single-Serve-Pods-Grounds-Hot-and-Iced-Coffee-Brewer-with-Rapid-Cold-Brew-PB045ST-Stone_8317964d-e524-4432-88fc-71e4fcc7c84c.ab30faf07d17d5648d0e8d1a06d83bf7.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF", "is_preowned": false, "is_sponsored": true, "item_id": "18439016545", "name": "Ninja Pods & Grounds Hot & Iced Single-Serve Coffee Maker, K-Cup Pod Compatible, Rapid Cold Brew, PB045ST, Stone", "offer_id": "B51B3B459A573DBEAE9CEE7388522EE9", "price": { "currency": "USD", "current_price": 79, "is_price_range": false, "max_price": 79.99, "min_price": 79, "savings": 10, "was_price": 89 }, "product_id": "6PP0IWY76E84", "rating": { "average": 4.5, "review_count": 1581 }, "seller": { "id": "F55CDC31AB754BB68FE0B39041159D63", "name": "Walmart.com" }, "url": "https://www.walmart.com/ip/Ninja-Single-Serve-Pods-Grounds-Hot-and-Iced-Coffee-Brewer-with-Rapid-Cold-Brew-PB045ST-Stone/18439016545?classType=VARIANT&athbdg=L1300" }, "… 52 more items in the full response" ], "query": "coffee maker", "related_searches": [ "coffee filters", "coffee", "… 8 more items in the full response" ], "returned": 54, "sort": "best_match", "title": "Results for \"coffee maker\"", "total_results": 3749, "url": "https://www.walmart.com/search?q=coffee+maker" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "walmart-search-v4", "billable": true, "duration_ms": 7823 }}