# Walmart Product Search

> Walmart Product Search 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, last successful call 2026-06-20).

Search Walmart's product catalog by keyword with filtering by price, location, category, and sort order

## Facts

- Endpoint: GET https://openwebninja-x402.vercel.app/api/walmart/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-06-20
- Success rate: 100% of calls made through Zero
- Activations on Zero: 44
- Tags: x402
- Canonical page: https://www.zero.xyz/c/walmart-product-search-f469ac01
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OurLkAqXbOAwWzQwkjSaW

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-product-search-f469ac01
```

Example prompt: Search Walmart for 'wireless earbuds' in the US, sorted by price low to high, with a max price of $50, near ZIP code 90210, and show me page 1 of results.

## When to prefer this

Use this endpoint when you need to search Walmart's product catalog programmatically — especially when you need price-range filtering, location-aware results via ZIP code, Canadian Walmart support, or specific sort orders like best seller or top rated. Prefer this over Amazon search endpoints when the user specifically wants Walmart pricing or availability.

## Known failure modes

- Missing required 'query' parameter returns validation error
- Invalid domain value (not 'us' or 'ca') causes schema rejection
- Invalid sort_by enum value rejected by schema
- Page number below 1 rejected by schema
- min_price or max_price below 0 rejected
- ZIP code format issues may return no local results
- Payment failure (insufficient USDC) blocks the request

## How this service works

Search Walmart products by keyword.

## Output

Returns a list of Walmart product listings matching the search query, including product names, prices, ratings, availability, and other catalog details filtered and sorted according to the specified parameters.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "zip": "90210",
   "page": 1,
   "query": "wireless earbuds",
   "domain": "us",
   "sort_by": "price_low",
   "max_price": 50
  }
 }
}
```

## 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": [
      "query"
     ],
     "properties": {
      "zip": {
       "type": "string",
       "minLength": 1
      },
      "page": {
       "type": "number",
       "minimum": 1
      },
      "facet": {
       "type": "string",
       "minLength": 1
      },
      "query": {
       "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
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/walmart-product-search-f469ac01/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)