# AgentUtility Shop Search

> AgentUtility Shop 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-14).

Searches the web for shoppable products and returns buy links, retailer info, prices, and product snippets for a given query

## Facts

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

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-shop-search-14ab8237 -d '<json body>'
```

Example prompt: Search for 'Sony WH-1000XM5 noise cancelling headphones' and give me the top 5 buy links with retailer names and prices — I want to see where I can actually purchase them right now.

## When to prefer this

Use this endpoint when an agent needs to find actionable purchase links for a product query, especially when buy intent is required and results must include retailer context and pricing signals. Prefer this over general web search when the goal is specifically shopping or price discovery, and over scrapers when you need structured product data with direct buy URLs already extracted.

## Known failure modes

- Query string missing or empty — returns validation error
- Query exceeds 300 character limit — returns input error
- No matching shopping results found for obscure or misspelled queries — empty results array
- Retailer filter narrows results to zero — empty results array
- Rate limiting or payment failure — request rejected with 402 or 429 status
- Downstream Decodo/Google Shopping outage — service temporarily unavailable

## How this service works

Shopping search API (alias of product-search). Find products and buy links for a query with title, buy link, retailer, snippet, and detected price. Backed by Decodo Google search scoped to buy intent.

## Output

Returns an array of product results each containing a rank, product title, direct buy URL, retailer name, and detected price, plus metadata about the query and data source (Decodo/Google Shopping).

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "standing desk 60 inch",
  "source": "Decodo Google Search (shopping intent)",
  "results": [
   {
    "rank": 1,
    "title": "Uplift V2",
    "buy_url": "https://example.com/uplift",
    "retailer": "example.com"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-shop-search-14ab8237/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)