# Xona Agent Google Lens Product Discovery

> Xona Agent Google Lens Product Discovery is a paid API for AI agents from api.xona-agent.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Identifies products in an image via Google Lens and optionally compares prices across Google Shopping, Amazon, and eBay

## Facts

- Endpoint: POST https://api.xona-agent.com/shop/lens
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xona-agent-google-lens-product-discovery-8c322527
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7HcOI1yWGYZN_YGo2biK3

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-google-lens-product-discovery-8c322527 -d '<json body>'
```

Example prompt: I found this lamp I love — can you identify what it is and find where I can buy it, sorted by lowest price? Here's the image URL: https://example.com/lamp.jpg. Use shop mode and check Google Shopping, Amazon, and eBay, filtering to new condition only.

## When to prefer this

Use this endpoint when you have a product image URL and want to identify what the product is and/or find where to buy it. Prefer this over text-based search when the user has a photo or screenshot of a product rather than a name. Choose mode=identify for fast, cheaper product identification; choose mode=shop when you also need live price comparisons across marketplaces. Not suitable for non-product images or when you already have a clear product name (use /shop/search instead).

## Known failure modes

- Image URL is not publicly reachable — returns error indicating inaccessible URL; call /api/shop/lens/quote first to validate
- Image does not contain a recognizable product — returns empty or low-confidence matches
- mode=shop with unsupported marketplace value — returns validation error
- price_min greater than price_max — returns filter error or empty results
- Image URL is a data URI or local upload — not supported, returns error
- Rate limiting or payment failure on x402 — returns 402 Payment Required

## How this service works

Product discovery from an image. Give a publicly reachable image URL and Google Lens identifies the product and the retailers selling it, normalized into the same schema as /shop/search. mode=identify (default) returns the visual matches and a derived product name; mode=shop additionally runs that product through Google Shopping, Amazon, and eBay for a price comparison, and costs more. Call the free POST /api/shop/lens/quote first to check the image URL is usable.

## Output

Returns a list of visual product matches normalized into a standard schema, including product name, image, retailer, URL, and price. In shop mode, also includes a cross-marketplace price comparison from Google Shopping, Amazon, and/or eBay with sorting and filtering applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Optional text refinement applied alongside the image, e.g. \"in black\" or \"size 10\""
  },
  "mode": {
   "type": "string",
   "description": "identify (default, Lens only) or shop (Lens plus a marketplace price comparison, higher price)"
  },
  "sort": {
   "type": "string",
   "description": "One of relevance, price_asc, price_desc, rating, reviews, discount (default relevance)"
  },
  "type": {
   "type": "string",
   "description": "Lens match type: visual_matches (default), products, exact_matches, all"
  },
  "limit": {
   "type": "number",
   "description": "Maximum matches to return, 1-50, default 20"
  },
  "country": {
   "type": "string",
   "description": "2-letter country code selecting the storefront (default us)"
  },
  "condition": {
   "type": "string",
   "description": "One of new, open_box, refurbished, used, for_parts"
  },
  "image_url": {
   "type": "string",
   "description": "Publicly reachable http(s) URL of the product image. Uploads and data URIs are not supported."
  },
  "price_max": {
   "type": "number",
   "description": "Maximum price filter applied to matches"
  },
  "price_min": {
   "type": "number",
   "description": "Minimum price filter applied to matches"
  },
  "marketplaces": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "mode=shop only. Restrict the comparison 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-google-lens-product-discovery-8c322527/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)