> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/walmart/category-products>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/walmart/category-products.mdx>

---

# Walmart Category Products API

List the products in a Walmart category or subcategory, sorted the way you need.

`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.

## Request

- **Endpoint:** `GET /v1/walmart/category/products`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by category id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/walmart/category/products/get)
- **Platform page:** [/platforms/walmart](https://www.socialfetch.dev/platforms/walmart)

## 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.
