Walmart Category Products API
List the products in a Walmart category or subcategory, sorted the way you need.
GET /v1/walmart/category/products1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/walmart/category/products?category=5427_486190 returns the category with its breadcrumbs, totalResults and products, about 40 a page, each with id, name, url, price, rating, reviewCount, sellerName, availability and badges. Paid placements come apart in sponsoredProducts.
Pass a category id such as 5427 or 5427_486190, or a category page URL from walmart.com. Order with sort and follow page.nextCursor while page.hasMore is true; page.truncated is true when the list stops before its end. An id Walmart does not have returns lookupStatus: not_found.
Some top-level departments, such as Toys (4171) and Cell Phones (1105910), are landing pages on Walmart with no product list of their own. For those the API answers a 400, not charged, that names the department's subcategory ids to ask for instead.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Walmart Category Products API FAQ
Where do I find a category id?
It is the number, or numbers joined by underscores, at the end of a walmart.com category URL, such as 5427_486190 in /browse/baby/diapering/5427_486190. You can pass the URL itself.
Why does a department such as Toys return an error?
Walmart shows some top-level departments only as a landing page of banners and shelves, with no product list. The API answers those with a 400 that is not charged and names subcategory ids, such as 4171_4172 for action figures, that do have a product list.
How deep can I page?
About ten pages, the depth Walmart serves. For a big category, narrow to a subcategory or change the sort to reach other products.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.