{"uid":"cap_PNjyFx6Andw33LB4Ti6oc","slug":"dealpulse-item-deal-lookup-3961561a","name":"DealPulse Item Deal Lookup","description":"Best price / cheapest deal / where to buy a specific product. Finds the best current price on a named product across all retailers worldwide, with applicable coupon and promo codes and buy links. For shopping and deal-hunting agents.","url":"https://dealpulse-weld.vercel.app/api/deals/item","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"lang":{"type":"string","description":"lang"},"query":{"type":"string","description":"Product name or description (e.g. 65 inch TV, AirPods Pro)"},"budget":{"type":"number","description":"Maximum budget in USD"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"query":"65 inch TV","budget":1500},"response":{"raw":"{\n  \"item\": \"65-inch TV\",\n  \"budget\": \"$1500\",\n  \"market_context\": \"65-inch TVs in the $1500 budget typically feature 4K resolution with HDR support. Current market offers models from established brands like Samsung, LG, TCL, and Hisense. Mid-year (June) is generally not a peak discount period, but summer sales are beginning.\",\n  \"best_deals\": [\n    {\n      \"rank\": 1,\n      \"retailer\": \"Best Buy\",\n      \"deal_type\": \"sale\",\n      \"title\": \"Samsung 65\\\" 4K Smart TV with Web OS\",\n      \"detail\": \"Look for Samsung QN65Q80C or similar 4K models typically priced $1200–$1450 during summer sales. Estimated savings: $200–$400 vs MSRP.\",\n      \"code\": null,\n      \"confidence\": \"medium\",\n      \"confidence_reason\": \"Best Buy frequently discounts 65\\\" 4K TVs in this range; exact model and price require real-time verification.\"\n    },\n    {\n      \"rank\": 2,\n      \"retailer\": \"Amazon\",\n      \"deal_type\": \"sale\",\n      \"title\": \"TCL 65\\\" 4K Roku Smart TV\",\n      \"detail\": \"TCL models (S555, S645, etc.) often available $900–$1300 with Prime shipping. Strong value proposition within budget. Estimated savings: $300–$500.\",\n      \"code\": null,\n      \"confidence\": \"medium\",\n      \"confidence_reason\": \"TCL consistently offers budget-friendly 4K options; price varies by exact model and promotions.\",\n      \"amazon_search\": \"65 inch 4K TV 4K Roku Smart\"\n    },\n    {\n      \"rank\": 3,\n      \"retailer\": \"Walmart\",\n      \"deal_type\": \"sale\",\n      \"title\": \"Hisense 65\\\" 4K Smart TV with Roku\",\n      \"detail\": \"Hisense models typically $1000–$1350 during promotional periods. Good picture quality at competitive price. Estimated savings: $250–$400.\",\n      \"code\": null,\n      \"confidence\": \"medium\",\n      \"confidence_reason\": \"Walmart matches competitor pricing; Hisense 65\\\" units generally land in lower end of budget.\"\n    },\n    {\n      \"rank\": 4,\n      \"retailer\": \"Costco (membership required)\",\n      \"deal_type\": \"bundle\",\n      \"title\": \"65\\\" TV + Warranty Bundle\",\n      \"detail\": \"Costco bundles 65\\\" TVs (LG OLED or Samsung QLED) with extended warranty/support, often $1200–$1500. Better long-term protection.\",\n      \"code\": null,\n      \"confidence\": \"medium\",\n      \"confidence_reason\": \"Costco pricing is real-time; membership gives added return protection and warranty options.\"\n    },\n    {\n      \"rank\": 5,\n      \"retailer\": \"Target\",\n      \"deal_type\": \"sale\",\n      \"title\": \"65\\\" 4K TV with Circle Earnings\",\n      \"detail\": \"Target Circle members earn 5% back on eligible electronics. Standard 65\\\" 4K models $1100–$1400, with $55–$70 earnings potential.\",\n      \"code\": null,\n      \"confidence\": \"low\",\n      \"confidence_reason\": \"Circle earnings are dynamic; not all TV brands/models qualify for bonus earnings rate.\"\n    }\n  ],\n  \"price_tip\": \"65\\\" 4K TVs in the $1500 range are historically most discounted during Black Friday/Cyber Monday, but mid-year summer sales (late June–early July) often deliver 15–25% off MSRP. Current pricing is moderate; expect better deals in August or November.\",\n  \"buy_now_or_wait\": \"either\",\n  \"buy_now_or_wait_reason\": \"If you find a TCL or Hisense 4K model at $1000–$1200, buy now — strong value and well under budget. If only seeing MSRP ($1600+), wait for summer sale event (late July) or Black Friday. Avoid impulse buys above $1350 unless it's an OLED or premium QLED.\",\n  \"disclaimer\": \"Prices and deals change rapidly. Verify at checkout. DealPulse surfaces real-time web intelligence but cannot guarantee current availability or pricing. Visit retailer sites directly to confirm current promotions, stock, and return policies.\"\n}\n```\n\n---\n\n**Quick checklist before you buy:**\n- [ ] Check **Best Buy**, **Amazon**, and **Walmart** for current 65\" 4K prices\n- [ ] Confirm **refresh rate** (60Hz vs 120Hz) and **panel type** (VA, IPS, OLED) match your needs\n- [ ] Look for **return window** (typically 30–60 days; Costco offers 90 days)\n- [ ] Ask about **delivery and installation** fees (often $50–$150)\n- [ ] Consider **extended warranty** (Costco, Best Buy often include free protection plan)","meta":{"sources":0},"affiliates":{"coupons":"https://www.retailmenot.com/","cashback":"https://www.rakuten.com/","deal_finder":"https://slickdeals.net/newsearch.php?q=65%20inch%20TV","price_tracker":"https://camelcamelcamel.com/","browser_savings":"https://capitaloneshopping.com/"},"parse_error":true,"generated_at":"2026-06-18T05:32:40.723Z"}},"exampleRequest":{"query":"65 inch TV","budget":1500},"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BUtMzeyb2f7eybVC-u4tD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the best current deal on a specific product across all retailers tracked by DealPulse","exampleAgentPrompt":"Can you check DealPulse for the best current deal on the Sony WH-1000XM5 headphones — I want to know which retailer has the lowest price right now?","exampleUseCases":[{"title":"Budget-conscious holiday gift shopping","prompt":"I'm trying to find the cheapest place to buy a Nintendo Switch for my nephew this holiday season — can you search DealPulse and tell me which retailer has the best deal right now?"},{"title":"Office equipment procurement at lowest cost","prompt":"We need to outfit our new office with Herman Miller Aeron chairs. Can you check DealPulse to find us the current best price and tell me where we should order from?"},{"title":"Real-time deal hunting for electronics","prompt":"I've been wanting to upgrade my laptop, and I found a MacBook Pro 16-inch M3 model I like. Can you use DealPulse to find me the absolute cheapest price available across all retailers right now?"}],"resultDescription":"Returns the best current deal for the specified product, including the retailer name, current price, discount amount or percentage, and a link to the product listing.","failureModes":["Product not found or not tracked — returns empty result or 404","Ambiguous product query matches multiple items — may return top match or error","No active deals available for the product — returns null deal or baseline price","Payment not processed or insufficient USDC — 402 payment required error","Rate limiting or upstream retailer data unavailable — 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need the single best current deal for a specific known product and want a fast, affordable lookup ($0.08/call) without building your own price-comparison scraping logic. Ideal for agents helping users shop, compare prices, or find discounts on named products in real time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:36.750Z","isFirstParty":false}