{"uid":"cap_K8m-S_xef9Wk9id6gqb5b","slug":"xona-agent-multi-marketplace-product-search-eb1d96d5","name":"Xona Agent Multi-Marketplace Product Search","description":"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.","url":"https://api.xona-agent.com/shop/search","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LT15hHH-43R1o5LWBe2mp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Google Shopping, Amazon, and eBay simultaneously from a single free-text query, normalizing and deduplicating results into one ranked list","exampleAgentPrompt":"Search Amazon and eBay for refurbished AirPods Pro under $150, sorted by lowest price, and show me the top 10 results from US storefronts.","exampleUseCases":[{"title":"Best-value refurbished electronics hunt","prompt":"Find me the top 10 refurbished AirPods Pro under $150 on Amazon and eBay, sorted by lowest price, in the US."},{"title":"Cross-marketplace gaming laptop comparison","prompt":"Search Google Shopping and Amazon for a new gaming laptop between $800 and $1200, sorted by highest rating, and show me the top 20 results."},{"title":"Discount deal finder for home appliances","prompt":"Look across all three marketplaces — Google Shopping, Amazon, and eBay — for a new robot vacuum under $400, sorted by biggest discount, and give me the top 15 options."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:47:52.841Z","isFirstParty":false}