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