# Walmart Product Search

> Walmart Product Search is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search Walmart's product catalog (US or Canada) with filters for price range, sort order, location, store, and facets, returning paginated product listings with prices and availability.

## Facts

- Endpoint: GET https://agents.openwebninja.com/real-time-walmart-data/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-walmart-product-search-a10d3ffc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Df2t09afnAhaJON8_C7Vf

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 agents-openwebninja-com-walmart-product-search-a10d3ffc
```

Example prompt: Search Walmart US for 'wireless headphones' sorted by top_rated, priced between $30 and $150, and show me the first page of results.

## When to prefer this

Use this endpoint when you need real-time Walmart product search results with flexible filtering by price, sort order, store location, or category facets, and need to return multiple paginated results. Prefer this over Amazon or eBay search endpoints when the user specifically wants Walmart pricing or availability, or when US/Canada store-level localization is needed.

## Known failure modes

- Missing required 'query' parameter returns a 400 validation error
- Invalid store_id may cause Walmart to default to a different store without warning
- Price filters where min_price >= max_price will be rejected
- Unavailable products or out-of-stock items may still appear in results
- store_id is currently ignored for the 'us' domain
- Facet strings must be obtained from a prior search response; invalid facets silently drop the filter
- Rate limits or payment failures return 402 or 429 errors from the proxy

## How this service works

Search for products on Walmart with pagination support and multiple filters and options such as sort by, price range, location, and more.

## Output

Returns a paginated list of Walmart products matching the query, each with title, price, currency, brand, seller, rating, product URL, image URL, shipping and pickup availability, and pre-order status. Also returns a location object confirming which store the prices were rendered for, and facet data for further filtering.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "number",
   "default": 1,
   "minimum": 1,
   "description": "Page number for pagination. Default is 1."
  },
  "facet": {
   "type": "string",
   "description": "Facet filter string for refining results (e.g. by brand, category). Obtained from a previous search response's facet data."
  },
  "query": {
   "type": "string",
   "description": "Search query string. E.g. 'laptop', 'iphone 15', 'nike shoes'"
  },
  "state": {
   "type": "string",
   "description": "US state code (e.g. 'CA', 'NY') to localize search results such as availability and shipping options."
  },
  "domain": {
   "enum": [
    "us",
    "ca"
   ],
   "type": "string",
   "default": "us",
   "description": "Walmart domain to search. 'us' for walmart.com, 'ca' for walmart.ca. Default is 'us'."
  },
  "sort_by": {
   "enum": [
    "best_match",
    "price_low",
    "price_high",
    "best_seller",
    "top_rated"
   ],
   "type": "string",
   "default": "best_match",
   "description": "Sort results by the given criteria. Accepts aliases: price_low, price_high, best_seller, top_rated. Default is best_match."
  },
  "store_id": {
   "type": "string",
   "description": "Walmart store ID to get store-specific prices and availability. Supported for domain 'ca': results are rendered for that walmart.ca store (e.g. '3148' for Lévis, QC) and the response `location` object confirms the store applied. Without it walmart.ca defaults to Mississauga Supercenter (store 1061). For domain 'us' this parameter is currently not applied to search results."
  },
  "max_price": {
   "type": "number",
   "description": "Maximum price filter. Must be higher than min_price if both are specified."
  },
  "min_price": {
   "type": "number",
   "description": "Minimum price filter. Must be lower than max_price if both are specified."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "location": {
     "type": "object",
     "nullable": true,
     "properties": {
      "city": {
       "type": "string",
       "nullable": true,
       "description": "City associated with the location. null on walmart.ca when store_id is set."
      },
      "state": {
       "type": "string",
       "nullable": true,
       "description": "State or province code. null on walmart.ca when store_id is set."
      },
      "store_id": {
       "type": "string",
       "description": "Walmart store ID the prices were rendered for."
      },
      "postal_code": {
       "type": "string",
       "nullable": true,
       "description": "Postal / ZIP code associated with the location. null on walmart.ca when store_id is set (Walmart does not return the selected store's address; use store_id)."
      }
     },
     "description": "The store location Walmart resolved this response for. Use it to verify which store the prices belong to. With no store_id, walmart.ca defaults to Mississauga Supercenter (store 1061) and walmart.com to a store near the request's exit location."
    },
    "products": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "url": {
        "type": "string",
        "description": "The product page URL."
       },
       "brand": {
        "type": "string",
        "description": "The product brand when available, otherwise null."
       },
       "image": {
        "type": "string",
        "description": "The main image URL for the product."
       },
       "price": {
        "type": "number",
        "description": "The current selling price of the product."
       },
       "title": {
        "type": "string",
        "description": "The product title."
       },
       "pickup": {
        "type": "boolean",
        "description": "Whether pickup is available for the product."
       },
       "rating": {
        "type": "number",
        "description": "The average product rating."
       },
       "seller": {
        "type": "string",
        "description": "The seller name for the product."
       },
       "currency": {
        "type": "string",
        "description": "The currency code for the displayed prices."
       },
       "position": {
        "type": "integer",
        "description": "The position of the product in the returned list."
       },
       "preorder": {
        "type": "boolean
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-walmart-product-search-a10d3ffc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)