# Walmart Products by Category

> Walmart Products by Category is a paid API for AI agents from stableninja.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Browse and list Walmart products filtered by a specific category ID, with optional sorting, pricing, and location filters.

## Facts

- Endpoint: GET https://stableninja.dev/api/walmart/products-by-category
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stableninja-dev-b7dc5eb7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B9Uxj2-CVX04xxH_S3bV4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stableninja-dev-b7dc5eb7
```

Example prompt: Show me the best-selling Walmart products in category '976759' near zip code 90210 in California, priced between $10 and $100, from the US store — sort by best_seller and start from page 1.

## When to prefer this

Use this endpoint when you need to browse or list Walmart products by a known category ID rather than a keyword search. Ideal for category-based navigation, price-range filtered browsing, or location-specific product discovery within a Walmart category tree.

## Known failure modes

- Invalid or nonexistent category_id returns empty results or 404
- Missing required category_id parameter returns 400 bad request
- Invalid sort_by value returns validation error
- Invalid zip code or state format returns error
- page number out of range returns empty results
- Invalid domain value returns schema validation error
- Upstream Walmart API unavailability causes 500 or timeout error

## How this service works

Browse Walmart products by category ID.

## Output

A paginated list of Walmart products within the specified category, including product names, prices, ratings, and other listing details, filtered and sorted according to the provided parameters.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "zip": "90210",
   "page": 1,
   "state": "CA",
   "domain": "us",
   "sort_by": "best_seller",
   "max_price": 100,
   "min_price": 10,
   "category_id": "976759"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stableninja-dev-b7dc5eb7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableninja.dev](https://www.zero.xyz/host/stableninja.dev/llms.txt)
