{"uid":"cap_gqMBnE9tRrFs88HzCjNeP","slug":"meld402-web-shopping-search-64cbca86","name":"meld402 Web Shopping Search","description":"14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.","url":"https://meld402.vercel.app/api/web/shopping","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"gl":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"Country code"},"hl":{"type":"string","default":"en","maxLength":2,"minLength":2,"description":"Language code"},"num":{"type":"integer","default":10,"maximum":20,"minimum":1,"description":"Number of products"},"query":{"type":"string","maxLength":500,"minLength":1,"description":"Product search query"},"max_price":{"type":"number","description":"Maximum price filter","exclusiveMinimum":0},"min_price":{"type":"number","description":"Minimum price filter","exclusiveMinimum":0}}},"responseSchema":{"type":"json","example":{"data":{"query":"wireless noise cancelling headphones","products":[{"url":"https://example.com/sony-wh1000xm5","price":"$348.00","title":"Sony WH-1000XM5","engine":"amazon","rating":4.7,"source":"Amazon","reviews":12500,"currency":"USD","position":1,"extracted_price":348},{"url":"https://example.com/bose-qc-ultra","price":"$429.00","title":"Bose QuietComfort Ultra","engine":"google_shopping","rating":4.6,"source":"Best Buy","reviews":8900,"currency":"USD","position":2,"extracted_price":429}],"total_results":1250000},"meta":{"as_of":"2026-08-24T00:00:00.000Z","sources":["serpapi"],"degraded":[],"attribution":["Search data by SerpApi (serpapi.com)"]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_u7Grbn7z5CaVu1SzZMRBC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for products across multiple shopping engines (Amazon, Google Shopping, etc.) and returns aggregated results with pricing, ratings, and reviews in a single stable schema, paid per request via USDC.","exampleAgentPrompt":"Search for wireless noise-cancelling headphones priced between $100 and $400, show me the top 10 results in the US with ratings and reviews from Amazon and Google Shopping.","exampleUseCases":[{"title":"Budget gift shopping with price cap","prompt":"Find me the top 10 wireless earbuds under $150 in the US — I want to see ratings and reviews so I can pick the best bang for the buck."},{"title":"Premium product price comparison","prompt":"Search for Sony WH-1000XM5 headphones and show me listings from different retailers with their prices, so I can find the best deal right now."},{"title":"Niche product discovery for a specific market","prompt":"Look up standing desks priced between $200 and $600 in the UK, give me up to 20 results with ratings and where to buy them."}],"resultDescription":"Returns a JSON object containing a list of up to 20 product listings, each with title, URL, price (formatted and numeric), currency, retailer name, shopping engine source, rating, review count, and result position. Also includes total result count, data timestamp, attribution credits, and any degraded sources.","failureModes":["Query too broad or missing — returns validation error","Price filter conflict (min > max) — may return empty or error","Country/language code invalid or unsupported — may fall back to defaults or error","SerpApi upstream outage — reflected in degraded sources field","Payment failure via x402 — request not processed","Result count of 0 if no products match the query and price filters"],"whenToPreferThis":"Choose this endpoint when you need aggregated shopping results from multiple retail sources (Amazon, Google Shopping) in a single call with a consistent schema, especially when price filtering and ratings matter. Prefer this over scraping individual retailer sites or calling separate shopping APIs, since it consolidates multiple sources, handles payment automatically via x402 USDC, and returns a stable normalized format suitable for autonomous agent pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:50.978Z","isFirstParty":false}