Walmart category
Walmart category (browse) listing.
Provide either the browse url or the cat_id on its own, Walmart
resolves a browse page on the trailing category id and ignores the slug
segments, so /browse/baby/strollers/5427_2911669_118134 and
/browse/5427_2911669_118134 are the same listing.
Category ids are hierarchical and underscore-joined (5427 is a department,
5427_2911669_118134 a shelf inside it); a shorter id is a broader listing.
The breadcrumbs on any response give you the ids of the levels above, and a
product's category_path on the PDP gives you the ids for a product you
already have.
Returns the same product shape as walmart-search-v4 and paginates the same
way, with the same ~500-product ceiling: measured on "Strollers", page 5
served 49 rows, page 10 served 36, page 11 served 12 and page 12 onwards
nothing, against a reported total_results of 6,446 and a max_page of
25. Narrow with a deeper cat_id (or a price range) to get past it rather
than paging on. An unknown category id is a clean 404; a real category
paged past its end is an empty list with has_more: false.
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-category-v4" \ -H "Content-Type: application/json" \ -d '{ "cat_id": "5427_2911669_118134" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "breadcrumbs": [ { "id": "5427", "name": "Baby", "url": "https://www.walmart.com/cp/5427" }, { "id": "5427_2911669", "name": "Baby Travel Gear", "url": "https://www.walmart.com/browse/baby/baby-travel-gear/5427_2911669" }, "… 1 more item in the full response" ], "cat_id": "5427_2911669_118134", "category_id": "5427_2911669_118134", "category_name": "Strollers", "has_more": true, "heading": "Baby Strollers and Travel Gear", "max_page": 25, "page": 1, "products": [ { "availability": { "display": "In stock", "in_stock": true, "status": "IN_STOCK" }, "badges": [ "Best seller" ], "category_path": "Home Page/Baby/Baby Travel Gear/Strollers/All baby strollers", "condition": 1, "flag": "Best seller", "fulfillment_type": "FC", "image": "https://i5.walmartimages.com/seo/Evenflo-Omni-Signature-Travel-System-with-LiteMax-infant-Car-Seat-Coastal-Cofee_54f43a46-01dc-44fe-be2c-9594ab5df526.e3afb9d025bc94224d12d69fb968bd5f.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF", "is_preowned": false, "is_sponsored": false, "item_id": "6788201050", "name": "Evenflo Omni Signature Travel System with LiteMax Infant Car Seat, Coastal Coffee", "offer_id": "322DF5E43FA03BCCBDBC61729E1B2D36", "price": { "currency": "USD", "current_price": 319, "is_price_range": false, "min_price": 175.1 }, "product_id": "3R9YFPWBMFRR", "rating": { "average": 4.5, "review_count": 3230 }, "seller": { "id": "F55CDC31AB754BB68FE0B39041159D63", "name": "Walmart.com" }, "short_description": "Evenflo Omni Signature Travel System with LiteMax infant Car Seat (Coastal Cofee)", "url": "https://www.walmart.com/ip/Evenflo-Omni-Signature-Travel-System-with-LiteMax-infant-Car-Seat-Coastal-Cofee/6788201050?classType=VARIANT&athbdg=L1600", "variant_count": 6 }, { "availability": { "display": "In stock", "in_stock": true, "status": "IN_STOCK" }, "category_path": "Home Page/Baby/Baby Travel Gear/Strollers/All baby strollers", "condition": 1, "fulfillment_type": "FC", "image": "https://i5.walmartimages.com/seo/Baby-Trend-EZ-Ride-Stroller-Travel-System-with-EZ-Lift-Infant-Car-Seat-Desert-Tan_b3746464-19b8-4576-8744-1b26ee6bb558.2a5defa1ceba4118fcbf3dac41ea083d.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF", "is_preowned": false, "is_sponsored": false, "item_id": "6928719483", "name": "Baby Trend EZ Ride Travel System (with EZ-Lift™ Infant Car Seat)", "offer_id": "4703B99E06CE3FE8AABD5AD3BB1C9F31", "price": { "currency": "USD", "current_price": 159, "is_price_range": false, "max_price": 159.99, "min_price": 159 }, "product_id": "3LO4XM9BQY1G", "rating": { "average": 4.4, "review_count": 2339 }, "seller": { "id": "F55CDC31AB754BB68FE0B39041159D63", "name": "Walmart.com" }, "short_description": "Baby Trend EZ Ride Travel System (with EZ-Lift Infant Car Seat)", "url": "https://www.walmart.com/ip/Baby-Trend-EZ-Ride-Stroller-Travel-System-with-EZ-Lift-Infant-Car-Seat-Desert-Tan/6928719483?classType=VARIANT", "variant_count": 3 }, "… 45 more items in the full response" ], "returned": 47, "sort": "best_match", "title": "Results for \"Strollers\"", "total_results": 6323, "url": "https://www.walmart.com/browse/5427_2911669_118134" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "walmart-category-v4", "billable": true, "duration_ms": 3955 }}