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