DealPulse — Real-Time Deal Intelligence API

Verify which deals are REAL at a store right now. First-party-only: merchant feed uploads + the merchant's own domain (sale pages, newsletter %, loyalty program), every offer with a source URL and source class. Optional claimed-code verdict: confirmed_first_party / unverified / no_trace. Third-party

Deterministic $0.25 subset of /api/deals/check: offers the merchant itself uploaded to its affiliate network (AWIN), source-linked, no LLM. No first-party web scan, no synthesized summary. Claimed-code verdict scoped to the feed only.

Live discounted gift-card rates for a brand across guaranteed resale marketplaces (CardCash, Raise, Fluz and peers), with stacked-savings math (card discount + promo + sale) and the honest risk picture (buyer guarantees, balance-theft cautions). Often the single largest discount available on a brand

Current promo codes, sales, and cashback for any store or restaurant. Each code has a confidence rating and recency signal. Includes cashback app opportunities and a best_play recommendation.

Best current deal on a specific product — ranked across sale, coupon, cashback, price match, bundle, and refurbished options. Includes buy_now_or_wait recommendation and price trend context.

Live price comparison across major retailers with shipping, return policy, and active promotions. Returns best_overall pick and effective price after promos.

Sale event intelligence — best deals rated genuinely_good / decent / hype / skip. Covers Black Friday, Prime Day, Cyber Monday, and any major sale event. Includes categories to target, categories to skip, and a shopping strategy.

Reviews a list of active subscriptions (streaming, software, etc.), flags overlap and waste to cancel or downgrade, and surfaces cheaper alternatives for each. Includes quick-win actions and estimated annual savings potential.

Best credit card for a spending category or specific purchase — maximizes cashback, points, or miles earned. Includes a no-annual-fee pick for beginners and a card-stacking tip.

Cashback stacking — layers shopping-portal cashback, credit-card rewards, coupon codes, and loyalty points to maximize savings on a purchase at a specific store. Returns the optimal stack and total estimated savings.

Verified student discounts by category, with how to prove eligibility and exact savings vs. regular price. Highlights the must-have verification programs (UNiDAYS, Student Beans, SheerID) to sign up for.

Price history and best-time-to-buy analysis for a product — historical low/high, trend direction, and a buy-now-or-wait verdict with reasoning.

Subscription-trap rights check — state auto-renewal law duties, violations, and remedy math (CA/NY/DC/VA/IL/VT/OR/HI/DE letter-worthy; FL void-refund tier; CO/WA/GA honest-no). Deterministic, no LLM.

Deterministic $0.25 preview of the subscription demand letter. Runs the same rule engine as /api/deals/subscription-letter and reports whether a letter is supportable, its type (refund_demand | gift_letter | obstruction_letter), and the computed refund/exposure numbers. No letter text, no LLM.

Citation-locked demand letter — refund, unconditional-gift (goods), or cancellation-obstruction under 10 states' ARLs, safe-harbor framed; in DE the letter IS the §2737(a) pre-suit notice.