# Xona Agent Multi-Marketplace Product Search

> Xona Agent Multi-Marketplace Product Search is a paid API for AI agents from api.xona-agent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Searches Google Shopping, Amazon, and eBay simultaneously from a single free-text query, normalizing and deduplicating results into one ranked list

## Facts

- Endpoint: POST https://api.xona-agent.com/shop/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xona-agent-multi-marketplace-product-search-eb1d96d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K8m-S_xef9Wk9id6gqb5b

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 xona-agent-multi-marketplace-product-search-eb1d96d5 -d '<json body>'
```

Example prompt: Search Amazon and eBay for refurbished AirPods Pro under $150, sorted by lowest price, and show me the top 10 results from US storefronts.

## When to prefer this

Choose this endpoint when you need cross-marketplace product comparison from a single natural language query, especially when price, condition, or marketplace preferences matter. It is ideal over single-marketplace APIs when deduplication and normalized ranking across Google Shopping, Amazon, and eBay are needed simultaneously. Use the free /api/shop/quote endpoint first if you want to validate how the query will be interpreted before paying per search.

## Known failure modes

- Ambiguous or very short query may be misinterpreted — check the /api/shop/quote endpoint first to validate how the query will be parsed
- Invalid marketplace name returns an error — only google_shopping, amazon, ebay are accepted
- Price filters that conflict with query-implied range may produce no results
- Invalid country code returns an error or defaults to US
- Limit out of range (below 1 or above 50) causes a validation error
- A marketplace may return no results for highly specific queries, reducing total result count

## How this service works

Product discovery across Google Shopping, Amazon, and eBay from a single free-text query. The query is parsed for price range, condition, sort, and target marketplaces, then results are normalized into one schema, deduped across marketplaces, and ranked. Price scales with the number of marketplaces searched; call the free POST /api/shop/quote first to check how a query will be interpreted.

## Output

A normalized, deduplicated list of up to 50 product listings across the requested marketplaces, each with product name, price, condition, marketplace source, rating, review count, and discount info, ranked by the requested sort order.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "One of relevance, price_asc, price_desc, rating, reviews, discount, newest (default relevance)"
  },
  "limit": {
   "type": "number",
   "description": "Maximum products to return, 1-50, default 20"
  },
  "query": {
   "type": "string",
   "description": "Free-text product query, e.g. \"cheapest refurbished airpods pro under $150\". Everything else is inferred from this."
  },
  "country": {
   "type": "string",
   "description": "2-letter country code selecting the marketplace storefront (default us)"
  },
  "condition": {
   "type": "string",
   "description": "One of new, open_box, refurbished, used, for_parts"
  },
  "price_max": {
   "type": "number",
   "description": "Maximum price filter, overrides what the query implied"
  },
  "price_min": {
   "type": "number",
   "description": "Minimum price filter, overrides what the query implied"
  },
  "marketplaces": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Restrict the search to any of google_shopping, amazon, ebay. Fewer marketplaces means a lower price."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xona-agent-multi-marketplace-product-search-eb1d96d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.xona-agent.com](https://www.zero.xyz/host/api.xona-agent.com/llms.txt)