{"uid":"cap_7HcOI1yWGYZN_YGo2biK3","slug":"xona-agent-google-lens-product-discovery-8c322527","name":"Xona Agent Google Lens Product Discovery","description":"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.","url":"https://api.xona-agent.com/shop/lens","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_x2XBqabR-bDb_6JH_noNd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Identifies products in an image via Google Lens and optionally compares prices across Google Shopping, Amazon, and eBay","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Identify clothing item from photo","prompt":"I took a photo of a jacket I saw someone wearing and want to know what it is and where to buy it. Here's the URL: https://example.com/jacket.jpg — just identify the product for me first, don't need prices yet."},{"title":"Price comparison for a photographed gadget","prompt":"I have a photo of a pair of headphones at https://example.com/headphones.jpg — can you find the best price for them across Amazon and eBay, new condition only, sorted by lowest price?"},{"title":"Find product matching room decor style","prompt":"Here's an image of a vase I saw in a magazine: https://example.com/vase.jpg — can you find visually similar products I can actually buy, in shop mode, and show me up to 10 results sorted by rating?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:06.199Z","isFirstParty":false}