{"uid":"cap_wDcIKAcIXjPuw-Xj3mbh5","slug":"agentutility-product-search-d846f47d","name":"AgentUtility Product Search","description":"Searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer domain, snippet, and any detected price. Backed by Decodo Google search scoped to buy intent. For general web search use search/web-search. Use it as a product search or shopping search API to find products and buy links for agents.","url":"https://x402.agentutility.ai/product-search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["query"],"properties":{"query":{"type":"string","description":"Product to find, e.g. 'noise cancelling headphones under 200'. Max 300 chars."},"retailer":{"type":"string","description":"Optional retailer/domain to scope to, e.g. 'amazon.com'."},"num_results":{"type":"number","description":"Results to return, 1-20. Default 10."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"price":{"type":"string"},"title":{"type":"string"},"buy_url":{"type":"string"},"retailer":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"query":"mechanical keyboard hot-swappable","source":"Decodo Google Search (shopping intent)","results":[{"rank":1,"price":"$99.00","title":"Keychron K8 Pro","buy_url":"https://example.com/k8","retailer":"example.com"}]}},"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_GC0fDnhdIIoInVTZlnSwe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the web for products matching a query (with optional retailer scoping) and returns ranked results with titles, buy links, retailer domains, snippets, and prices","exampleAgentPrompt":"Search for noise cancelling headphones under $200 and give me the top 5 results with buy links — scope it to amazon.com if you can.","exampleUseCases":[{"title":"Budget gift shopping for a friend","prompt":"Find me the top 10 products for 'wireless earbuds under $50' so I can pick a gift — include the prices and where to buy them."},{"title":"Price hunting on specific retailer","prompt":"Search for a standing desk on wayfair.com and show me the top 3 results with direct buy links and prices."},{"title":"Product research for purchasing decision","prompt":"Look up 'mechanical keyboard for programming' and return 8 results with titles, prices, and buy links so I can compare my options."}],"resultDescription":"A ranked list of up to 20 product results, each containing: rank position, product title, direct buy URL, retailer domain, descriptive snippet, and detected price string (if available). Also includes the original query and the data source.","failureModes":["Query string exceeds 300 characters — truncate or simplify the query","No results found for very niche or misspelled product queries","Price detection may return null if the retailer hides prices before cart","Retailer scoping may reduce results significantly for obscure product-retailer combos","Payment failure (x402) if USDC balance is insufficient — call returns 402 status"],"whenToPreferThis":"Use this endpoint when an agent needs to find products to purchase, compare prices across retailers, or retrieve direct buy links for a specific item. Prefer this over a general web search endpoint when the user's intent is clearly transactional (buy, purchase, find price). Use the optional retailer parameter when the user specifies a store like amazon.com or walmart.com. For non-shopping informational queries, use a general web search endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:11:02.867Z","isFirstParty":false}