Products of one category page with sort, facet filter (for example brand:Samsung) and pagination, in the same item shape as Walmart Product Search. Reports the real last page and total. Walmart serves at most 25 pages per category. Category slugs and ids come from the categories endpoint. Works for walmart.com and walmart.ca (category ids differ between the two sites). Paid placements are removed so pages do not overlap. For sort=price_low or price_high the page is ordered by price when Walmart returns it out of order; search_metadata.sort_applied says server or page, and ordering applies within the returned page. A category without products, or one that Walmart serves as a content page, answers 404. A page past the last page is an empty list. Both cost nothing. Costs 1 credit per successful request with items. Failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
4 optional filters available.
string
Required
Category slug, e.g. electronics.
example
string
Required
Category id, e.g. 3944.
1234567890
integer
Optional
Page number, 1-indexed. Default: 1. Walmart serves at most 25 pages.
1
string
Optional
best_match (default), price_low, price_high, rating_high, new.
relevance
string
Optional
Facet filter name:value, e.g. brand:Samsung.
example
string
Optional
Marketplace: us (walmart.com, default) or ca (walmart.ca).
US
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 404
Walmart has no page for this request. This response is not billable.
HTTP 422
A public parameter is invalid. This response is not billable.
HTTP 503
Walmart did not return usable data for this request. This response is not billable.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.