{"uid":"cap_IBAXw-A6pZb6kBHVf2xrn","slug":"deal-verdict-api-5516c025","name":"Deal Verdict API","description":"Resolve a plain-language product to canonical models, check every reachable retailer, and return a single deal verdict (deal / no deal / insufficient data) with a discount, confidence, and coverage report. Sells the answer, not the underlying listings. Human UI (connect a wallet in-browser): https://deal-verdict-frontend-production.up.railway.app","url":"https://deal-verdict-api-production.up.railway.app/verdict","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"product":{"type":"string","description":"The product to shop for, in plain language. Brand and model help but are not required, e.g. '50 gallon natural gas water heater' or 'Bosch 800 series dishwasher'."},"category":{"type":"string","description":"Optional coarse category hint."},"location":{"type":"string","description":"Optional city or ZIP. Localizes the price searches to that area (a city suits the aggregated feed; a ZIP localizes store delivery). No per-store fan-out."},"variants":{"type":"array","items":{"type":"string"},"description":"Optional size/variant hints, e.g. ['50 gallon']."},"attribute":{"type":"string","description":"A required attribute, e.g. 'gas', 'stainless', '15-inch'."},"product_url":{"type":"string","description":"Optional link to a specific product page. The service reads the page's title, model/SKU, and price to identify the exact product and default the reference price. Only the answer is returned - never the page's content or URL."},"reference_price":{"type":"number","description":"Optional. Your own reference/list price to judge against. If omitted, the service uses a trailing median of observed prices."},"discount_threshold":{"type":"number","description":"How deep a discount counts as a deal, as a fraction off the reference price. 0.30 means 'only tell me if something is at least 30% off'. Defaults to the service setting."}}},"responseSchema":{"type":"json","example":{"leads":[],"price":591,"methods":["per-store retailer lookup"],"summary":"A deal was found: home_depot is 21.0% below the computed reference price for this product, at $591.00, which meets your requested threshold of 15% off. Checked 3 retailer(s).","verdict":"deal_found","retailer":"home_depot","store_id":"6970","confidence":"high","price_verified":true,"size_or_variant":"50 gallon","reference_source":"computed","merchants_checked":["home_depot","lowes","walmart"],"best_discount_found":0.21,"threshold_requested":0.15,"merchants_unreachable":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rkz9ydKjZg15q3EU4fFvE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Determines whether a specific product is meaningfully discounted right now across multiple retailers, returning a single verdict: deal_found, no_deal, or insufficient_data.","exampleAgentPrompt":"Check if the DeWalt 20V MAX drill is genuinely on sale right now at Home Depot, Lowe's, or Walmart — I want at least 20% off the normal price before I buy.","exampleUseCases":[{"title":"Home improvement purchase timing","prompt":"I'm thinking about buying a 50-gallon water heater — can you check if it's meaningfully discounted at Home Depot or Lowe's right now? I'd want at least 15% off before pulling the trigger."},{"title":"Seasonal appliance deal check","prompt":"Is a Dyson V15 vacuum actually on sale anywhere right now, or are the prices just inflated 'sale' prices? I want a real discount of at least 20% off the normal price."},{"title":"Gift purchase deal verification","prompt":"I found a KitchenAid stand mixer listed at $349 on Walmart — is that actually a good deal? Check if it's at least 15% below what it normally sells for across major retailers."}],"resultDescription":"A JSON object containing: a verdict string (deal_found, no_deal, or insufficient_data), the current best price found, the retailer offering that price, the store ID, the best discount percentage found, the requested threshold, a list of merchants checked and unreachable, confidence level (high/medium/low), whether the price was verified, the reference price source, size/variant matched, and a plain-English summary explaining the verdict.","failureModes":["Retailer pages unreachable or blocked — listed in merchants_unreachable with verdict potentially downgraded to insufficient_data","Product not found at any checked retailer — returns insufficient_data verdict","Ambiguous product name matches wrong variant — size_or_variant field may indicate mismatch","Reference price cannot be computed — reference_source falls back to computed with lower confidence","Payment failure — x402 payment of $0.05 USDC not processed, request rejected before execution"],"whenToPreferThis":"Choose this endpoint when you need a single definitive buy/no-buy signal for a specific product rather than a raw price feed or product search results. It is ideal for automating purchase decisions, deal alerts, or budget-conscious shopping workflows where the agent must resolve a boolean 'is this actually on sale?' question without building custom price-comparison logic. Prefer it over general price APIs when you want multi-retailer coverage collapsed into one verdict with a configurable discount threshold.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:10.899Z","isFirstParty":false}