{"uid":"cap_dxhkW6joeF_9k5grPHOAJ","slug":"best-price-cross-retailer-lowest-price-finder-60e1e512","name":"Best Price — Cross-Retailer Lowest Price Finder","description":"Find the lowest current price for a product across Amazon, Walmart, Costco, Home Depot, Nordstrom, and IKEA in US and Canada. Returns the cheapest option plus other retailer prices for comparison.","url":"https://api.syntalic.com/v1/shopper/best-price","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","example":"airpods","minLength":1,"description":"Search query (product name, keyword, or category term)"},"limit":{"type":"integer","default":10,"example":10,"maximum":50,"description":"Max results to return (default 10, max 50)"},"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"},"retailer":{"enum":["amazon","walmart","costco","homedepot","nordstrom","ikea"],"type":"string","example":"amazon","description":"Filter to a specific retailer"}},"additionalProperties":false},"responseSchema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"best_price":{"type":"object","properties":{"price":{"type":"number"},"in_stock":{"type":"boolean"},"retailer":{"type":"string"},"condition":{"enum":["new","refurbished","used","unknown"],"type":"string","description":"Derived from product name + retailer URL signals (e.g. Walmart 'Restored', Amazon Renewed). Defaults to 'new' when no condition signal is present."},"list_price":{"type":"number","nullable":true},"scraped_at":{"type":"string","format":"date-time"},"savings_pct":{"type":"number","nullable":true},"product_name":{"type":"string"}}},"other_prices":{"type":"array","items":{"type":"object","properties":{"price":{"type":"number"},"in_stock":{"type":"boolean"},"retailer":{"type":"string"},"condition":{"enum":["new","refurbished","used","unknown"],"type":"string"}}}}}},"example":null,"exampleRequest":null,"tags":["x402","shopping"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C3h1Y_mAgoaW-Yq0yLiZW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds the lowest current price for a product across Amazon, Walmart, Costco, Home Depot, Nordstrom, and IKEA in the US or Canada, returning the cheapest option plus comparison prices from other retailers.","exampleAgentPrompt":"What's the cheapest place to buy AirPods Pro right now in the US — check Amazon, Walmart, Costco, and the other major retailers and tell me the best price and where else I can find it.","exampleUseCases":null,"resultDescription":"Returns the single best (lowest) price found, including retailer name, product name, exact price, currency, in-stock status, product condition (new/refurbished/used/unknown), list price, savings percentage, and the datetime it was scraped. Also returns an array of other retailer prices for comparison, each with retailer, price, in-stock status, and condition.","failureModes":["No results found for query — product not carried by any covered retailer","Invalid country code — must be 'us' or 'ca'","Invalid retailer filter — must be one of the six supported retailers","Query too short or empty — minimum 1 character required","Retailer scrape temporarily unavailable — partial results returned","Product out of stock at all retailers — in_stock false across all results"],"whenToPreferThis":"Use this endpoint when you need a real-time lowest price across major US or Canadian retailers (Amazon, Walmart, Costco, Home Depot, Nordstrom, IKEA) for a specific product or keyword. Prefer this over general web search for shopping when you want structured price data with in-stock status, condition, and savings percentage in a single call. Ideal for price-aware purchasing decisions, deal detection, and quick cross-retailer arbitrage checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:15.924Z","isFirstParty":false}