{"uid":"cap_OPbrr5-vTX2pVNJdawrAs","slug":"x402serps-shopping-search-e18f7f34","name":"x402serps Shopping Search","description":"x402serps: Shopping product results (title, price, store, rating, url, image) for one query, up to 20","url":"https://x402serps.com/api/v1/shopping?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Query (alias: query)"},"gl":{"type":"string","description":"Country code, e.g. us, gb"},"num":{"type":"number","description":"Results 1-20, default 10"}}},"responseSchema":{"type":"json","example":{"query":"noise cancelling headphones","results":[{"url":"https://example.com/p/1","price":"$199.00","title":"Example ANC Headphones","rating":4.5,"source":"Example Store","imageUrl":"https://example.com/p/1.jpg","position":1}],"provider":"primary"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qcXAuBhLFdyoxfkLR-zvz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns shopping product results (title, price, store, rating, URL, image) for a single query, up to 20 products","exampleAgentPrompt":"Search for 'wireless noise-cancelling headphones' and give me the top 15 shopping results with prices, store names, ratings, and product images — look in the US market.","exampleUseCases":[{"title":"Price comparison for a specific product","prompt":"Find me shopping results for 'Sony WH-1000XM5 headphones' — I want to see prices from different stores along with ratings and images, up to 20 results, searching in the US."},{"title":"Gift idea product discovery","prompt":"I need to find gift ideas under a certain price — search for 'personalized leather wallet gifts for men' and show me up to 15 shopping listings with prices, ratings, and store names from the UK market."},{"title":"Competitive product research","prompt":"Search for 'standing desk electric adjustable' and pull the top 20 shopping results including prices, store sources, ratings, and product URLs so I can compare what's out there."}],"resultDescription":"A JSON object containing the original query string, provider name, and an array of up to 20 product results each with: position, productId, title, price (string), source (store name), rating (numeric), ratingCount, URL, and imageUrl.","failureModes":["Invalid or missing query returns an error","num parameter out of range (must be 1-20) may return an error or be clamped","Invalid country code (gl) may return no results or default to a fallback country","Payment failure via x402 protocol results in 402 response with no data","Query with no shopping results returns an empty results array","Rate limiting or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need structured shopping/product data including prices, store sources, ratings, and product images for a single search query. Prefer it over generic web search when the user specifically wants to find where to buy something, compare prices across retailers, or surface product listings with e-commerce metadata. It is especially useful for price comparison, gift recommendation, or product research workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T12:34:36.254Z","isFirstParty":false,"canonicalSlug":"x402serps-shopping-search-e18f7f34"}