StackTheDeal Deals

List live deals currently published on StackTheDeal (stackthedeal.com). Deals are verified on the retailer's own page before posting. Returns the newest deals first, with price, regular price, discount percentage, store, and a link to each deal's page on stackthedeal.com (results link to our pages only — the retailer's link lives on that page).

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Category filter, e.g. amazon, electronics, home, baby-kids, travel, bonus."
    },
    "store": {
      "type": "string",
      "description": "Store filter, exact name, e.g. Amazon, Walmart, Costco."
    },
    "min_discount_pct": {
      "type": "number",
      "description": "Only deals at least this percent off (0-100)."
    },
    "hot_only": {
      "type": "boolean",
      "description": "Only deals StackTheDeal flagged as hot."
    },
    "limit": {
      "type": "integer",
      "description": "Max deals to return (1-50, default 20)."
    }
  },
  "additionalProperties": false
}

Search StackTheDeal's live deals by keyword(s) — matched against deal titles, summaries, store and category. Use for questions like 'find me a deal on a coffee maker' or 'any LEGO deals?'. Results are StackTheDeal's verified site deals.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search words, e.g. 'air fryer' or 'LEGO'."
    },
    "limit": {
      "type": "integer",
      "description": "Max deals to return (1-50, default 20)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Get one deal by its slug (the last part of its stackthedeal.com/deals/<slug>/ URL), including whether it is still live.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The deal slug, e.g. from a list_deals or search_deals result."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

StackTheDeal at a glance: how many deals are live right now, which stores they cover, how many are flagged hot, and when the data was last updated.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

The deals StackTheDeal flagged as hottest right now: price-mistake / glitch deals first, then hot deals, newest first. All live and verified. Use for 'what are the best deals right now?' questions. Results link to each deal's page on stackthedeal.com only.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max deals to return (1-50, default 20)."
    }
  },
  "additionalProperties": false
}

Live deals whose end time falls within the next 48 hours (configurable), soonest-ending first, each with hours_left. Use for 'what deals are ending today / about to expire?' questions. Results link to each deal's page on stackthedeal.com only.

{
  "type": "object",
  "properties": {
    "within_hours": {
      "type": "number",
      "description": "Only deals ending within this many hours from now (default 48, max 720)."
    },
    "limit": {
      "type": "integer",
      "description": "Max deals to return (1-50, default 20)."
    }
  },
  "additionalProperties": false
}

All live deals at one store, exact name match — e.g. 'Amazon', 'Walmart', 'Costco', 'B&H'. Use for 'what deals does Walmart have?' questions. Results link to each deal's page on stackthedeal.com only.

{
  "type": "object",
  "properties": {
    "store": {
      "type": "string",
      "description": "Store name, e.g. Amazon, Walmart, Costco."
    },
    "limit": {
      "type": "integer",
      "description": "Max deals to return (1-50, default 20)."
    }
  },
  "required": [
    "store"
  ],
  "additionalProperties": false
}

Credit-card welcome offers and bank-account bonuses currently published on StackTheDeal: card name, headline offer, welcome bonus and annual fee (bank bonuses carry their fee terms instead). Each result links to the offer's page on stackthedeal.com — the apply link lives on that page; no bank or referral links are returned here.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "card",
        "bank_bonus"
      ],
      "description": "Only credit cards, or only bank-account bonuses. Omit for both."
    },
    "limit": {
      "type": "integer",
      "description": "Max offers to return (1-50, default 20)."
    }
  },
  "additionalProperties": false
}

Live deals that need a coupon/promo code at checkout, each with its coupon_code spelled out. Use for 'any coupon codes?' questions. Results link to each deal's page on stackthedeal.com only.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max deals to return (1-50, default 20)."
    }
  },
  "additionalProperties": false
}