# AgentUtility Product Search

> AgentUtility Product Search is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-16).

Searches the web for products matching a query (with optional retailer scoping) and returns ranked results with titles, buy links, retailer domains, snippets, and prices

## Facts

- Endpoint: POST https://x402.agentutility.ai/product-search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-product-search-d846f47d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wDcIKAcIXjPuw-Xj3mbh5

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 agentutility-product-search-d846f47d -d '<json body>'
```

Example prompt: Search for noise cancelling headphones under $200 and give me the top 5 results with buy links — scope it to amazon.com if you can.

## When to prefer this

Use this endpoint when an agent needs to find products to purchase, compare prices across retailers, or retrieve direct buy links for a specific item. Prefer this over a general web search endpoint when the user's intent is clearly transactional (buy, purchase, find price). Use the optional retailer parameter when the user specifies a store like amazon.com or walmart.com. For non-shopping informational queries, use a general web search endpoint instead.

## Known failure modes

- Query string exceeds 300 characters — truncate or simplify the query
- No results found for very niche or misspelled product queries
- Price detection may return null if the retailer hides prices before cart
- Retailer scoping may reduce results significantly for obscure product-retailer combos
- Payment failure (x402) if USDC balance is insufficient — call returns 402 status

## How this service works

Searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer domain, snippet, and any detected price. Backed by Decodo Google search scoped to buy intent. For general web search use search/web-search. Use it as a product search or shopping search API to find products and buy links for agents.

## Output

A ranked list of up to 20 product results, each containing: rank position, product title, direct buy URL, retailer domain, descriptive snippet, and detected price string (if available). Also includes the original query and the data source.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "Product to find, e.g. 'noise cancelling headphones under 200'. Max 300 chars."
      },
      "retailer": {
       "type": "string",
       "description": "Optional retailer/domain to scope to, e.g. 'amazon.com'."
      },
      "num_results": {
       "type": "number",
       "description": "Results to return, 1-20. Default 10."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "query": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "rank": {
          "type": "integer"
         },
         "price": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "buy_url": {
          "type": "string"
         },
         "retailer": {
          "type": "string"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "mechanical keyboard hot-swappable",
  "source": "Decodo Google Search (shopping intent)",
  "results": [
   {
    "rank": 1,
    "price": "$99.00",
    "title": "Keychron K8 Pro",
    "buy_url": "https://example.com/k8",
    "retailer": "example.com"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-product-search-d846f47d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)