Skip to main content
GET
Browse a Category
Browse a Walmart category by its browse path. Returns the same SearchResponse shape as /search. Credits: 5
No sort parameter. Walmart’s browse pages ignore it — sorted and unsorted requests returned 34/38 identical item ids with identical leading results, and Walmart does not echo the parameter back. Sort on /search instead.

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
required
Walmart browse path ending in its category id, taken from a walmart.com/browse/... URL. All of electronics/3944, browse/electronics/3944 and cp/3944 work. A sub-category id is the full underscore-joined path of ids: Toys › Action Figures is toys/action-figures/4171_4172, not action-figures/4172.
integer
default:"1"
Result page, 1–11. Browse dries up after page 11.
number
Minimum price in USD. Walmart filters on whole dollars only, so the value is rounded down (99.50 is sent as 99).
number
Maximum price in USD, rounded up to a whole dollar (199.99 is sent as 200).
string
Walmart facet filter, e.g. brand:HP. Facets can be applied but not enumerated.

Hub departments

Some top-level departments, such as Toys (toys/4171), render on walmart.com as a curated hub page rather than a product grid. For those, /category returns the department’s full product grid from Walmart’s category-scoped search instead. The result shape is the same, title is the department name and url is the page actually scraped. page, min_price, max_price and facet all apply.

Errors

Response

Identical to /search: query (null here), url, page, total_results_reported, max_page (11), result_count, has_more_pages, title, breadcrumbs, related_searches, and items[] of SearchItem.

Example

Response
total_results_reported is Walmart’s own claim (900,010 above) and is not reachable — browse stops returning products after page 11, roughly 500 products. Page on has_more_pages, and deduplicate on us_item_id: consecutive pages overlap by about 20% because Walmart re-ranks between requests. Segment by facet or price band to go deeper.