# Walmart Products by Category

> Walmart Products by Category is a paid API for AI agents from openwebninja-x402.vercel.app, 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, price filtering, and location context.

## Facts

- Endpoint: GET https://openwebninja-x402.vercel.app/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/walmart-products-by-category-5b0e1a36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pybRqV7Vz9zUVIVHu6UXE

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 walmart-products-by-category-5b0e1a36
```

Example prompt: Show me the best-selling Walmart products in category 4125 for US customers, sorted by best_seller, with prices between $10 and $100, near zip code 90210.

## When to prefer this

Use this endpoint when you need to browse or list Walmart products within a known category ID, especially when you want to apply price filters, sort options, or location context. Prefer this over keyword search when you already know the category and want broad category browsing rather than keyword-driven results.

## Known failure modes

- Invalid or non-existent category_id returns empty results or error
- Missing required category_id parameter causes 400 error
- Invalid domain value (not 'us' or 'ca') causes validation error
- Invalid sort_by value causes validation error
- Payment not processed (x402 payment required) returns 402 status
- Page number out of range returns empty results

## 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, and relevant metadata, filtered and sorted according to the provided parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "category_id"
     ],
     "properties": {
      "zip": {
       "type": "string",
       "minLength": 1
      },
      "page": {
       "type": "number",
       "minimum": 1
      },
      "facet": {
       "type": "string",
       "minLength": 1
      },
      "state": {
       "type": "string",
       "maxLength": 8,
       "minLength": 2
      },
      "domain": {
       "enum": [
        "us",
        "ca"
       ],
       "type": "string"
      },
      "sort_by": {
       "enum": [
        "best_match",
        "price_low",
        "price_high",
        "best_seller",
        "top_rated"
       ],
       "type": "string"
      },
      "store_id": {
       "type": "string",
       "minLength": 1
      },
      "max_price": {
       "type": "number",
       "minimum": 0
      },
      "min_price": {
       "type": "number",
       "minimum": 0
      },
      "category_id": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/walmart-products-by-category-5b0e1a36/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from openwebninja-x402.vercel.app](https://www.zero.xyz/host/openwebninja-x402.vercel.app/llms.txt)