---
type: "firecrawl-provider"
description: "Public coupon codes and deals from Honey by PayPal (joinhoney.com) for a store given by name, Honey label, merchant domain or joinhoney.com store URL: each code with its discount, minimum spend, Honey's badge (Verified, Popular), uses and when it last worked, plus the store's no-code sales and average member savings. Also finds stores by name, lists Honey's most-shopped stores and the stores currently running a sale. Read from the same anonymous API the public joinhoney.com store pages call; no account, key or extension."
use_when: "Public coupon codes and deals from Honey by PayPal (joinhoney.com) for a store given by name, Honey label, merchant domain or joinhoney.com store URL: each code with its discount, minimum spend, Honey's badge (Verified, Popular), uses and when it last worked, plus the store's no-code sales and average member savings. Also finds stores by name, lists Honey's most-shopped stores and the stores currently running a sale. Read from the same anonymous API the public joinhoney.com store pages call; no account, key or extension."
categories: "Retail"
capabilities: 4
credits_per_call: 5
---
# Honey (PayPal) coupons on Firecrawl Alexandria

Public coupon codes and deals from Honey by PayPal (joinhoney.com) for a store given by name, Honey label, merchant domain or joinhoney.com store URL: each code with its discount, minimum spend, Honey's badge (Verified, Popular), uses and when it last worked, plus the store's no-code sales and average member savings. Also finds stores by name, lists Honey's most-shopped stores and the stores currently running a sale. Read from the same anonymous API the public joinhoney.com store pages call; no account, key or extension.

- Categories: Retail
- Category index: [Retail category](https://alexandria.firecrawl.dev/agents/categories/retail)
- Provider key: `joinhoney-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/joinhoney-com)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/openapi.json)

## Capabilities

- [Search stores](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/search_stores): Find Honey stores by name with the joinhoney.com search box autocomplete: store id, label (for store_coupons), name, country and Honey page, plus the product search suggestions Honey shows. Empty when nothing matches. One request.
- [Store coupons](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/store_coupons): Public coupon codes and deals Honey lists for one store, as on its joinhoney.com/shop/<label> page. The store can be a Honey label (kohls, best-buy), a store name (Best Buy), a merchant domain (bestbuy.com, verified against the store's URL) or a joinhoney.com store URL. Each code: code, description, discount, minimum spend, flags (free shipping, sitewide, exclusions), Honey badge, exclusive, uses and last_worked_at; each deal: description, discount and landing URL. Also the store's id, website, average member savings over 30 days and savings found in 24 hours. Honey publishes no expiry dates. 1 to 3 requests.
- [Stores on sale](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/stores_on_sale): Stores Honey currently flags as running a sale, most popular first, with the largest and most common discount and the share of the store's items that are discounted. Pages with continuation. One request.
- [Top stores](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/top_stores): Honey's most-shopped stores for a country in Honey's own order, with shoppers in the last 24 hours and 30 days, savings found and average member savings in USD. One request.

## 1. Choose this provider when

Public coupon codes and deals from Honey by PayPal (joinhoney.com) for a store given by name, Honey label, merchant domain or joinhoney.com store URL: each code with its discount, minimum spend, Honey's badge (Verified, Popular), uses and when it last worked, plus the store's no-code sales and average member savings. Also finds stores by name, lists Honey's most-shopped stores and the stores currently running a sale. Read from the same anonymous API the public joinhoney.com store pages call; no account, key or extension.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "joinhoney-com",
  "capability": "coupons/search_stores",
  "options": {
    "query": "nike"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `limit` (number): Maximum stores to return. Example: `10`
- `query` (string, required): Store name or part of it, e.g. nike or home depot. Example: `<query>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "joinhoney-com",
    capability: "coupons/search_stores",
    options: {
      query: "nike",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "joinhoney-com",
  "capability": "coupons/search_stores",
  "options": {
    "query": "nike"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "joinhoney-com",
    "capability": "coupons/search_stores",
    "options": {
      "query": "nike"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'joinhoney-com/coupons/search_stores' \
  --options '{"query":"nike"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "joinhoney-com",
  "capability": "coupons/search_stores",
  "options": {
    "query": "nike"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "joinhoney-com",
  "capability": "coupons/search_stores",
  "options": {
    "query": "nike"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "count": 5,
  "observed_at_ms": 1794340022666,
  "query": "nike",
  "source_url": "https://d.joinhoney.com/v3?operationName=web_autocomplete&variables=%7B%22query%22%3A%22nike%22%7D",
  "stores": [
    {
      "country": "US",
      "label": "nike",
      "name": "Nike",
      "shop_url": "https://www.joinhoney.com/shop/nike",
      "store_id": "7359188627743309100"
    },
    {
      "country": "US",
      "label": "nielsen",
      "name": "Nielsen",
      "shop_url": "https://www.joinhoney.com/shop/nielsen",
      "store_id": "398791816580311916"
    },
    {
      "country": "US",
      "label": "naked-wardrobe",
      "name": "Naked Wardrobe",
      "shop_url": "https://www.joinhoney.com/shop/naked-wardrobe",
      "store_id": "214984998583157841"
    },
    {
      "country": "US",
      "label": "nine-west",
      "name": "Nine West",
      "shop_url": "https://www.joinhoney.com/shop/nine-west",
      "store_id": "7394093717368591472"
    },
    {
      "country": "US",
      "label": "nikon",
      "name": "Nikon",
      "shop_url": "https://www.joinhoney.com/shop/nikon",
      "store_id": "132"
    }
  ],
  "suggested_queries": [
    "nike socks",
    "nike",
    "nike shoes men",
    "nike shoes",
    "nike shoes women"
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Search stores

- Capability: `coupons/search_stores`
- Description: Find Honey stores by name with the joinhoney.com search box autocomplete: store id, label (for store_coupons), name, country and Honey page, plus the product search suggestions Honey shows. Empty when nothing matches. One request.
- Instructions: Resolving a store name to the Honey label before store_coupons, or checking whether Honey covers a store.
- Cost: 5 credits per call
- Capability file: [Search stores](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/search_stores)

Accepted options:
- `limit` (number): Maximum stores to return. Example: `10`
- `query` (string, required): Store name or part of it, e.g. nike or home depot. Example: `<query>`

Response schema example:
```json
{
  "count": 5,
  "observed_at_ms": 1794340022666,
  "query": "nike",
  "source_url": "https://d.joinhoney.com/v3?operationName=web_autocomplete&variables=%7B%22query%22%3A%22nike%22%7D",
  "stores": [
    {
      "country": "US",
      "label": "nike",
      "name": "Nike",
      "shop_url": "https://www.joinhoney.com/shop/nike",
      "store_id": "7359188627743309100"
    },
    {
      "country": "US",
      "label": "nielsen",
      "name": "Nielsen",
      "shop_url": "https://www.joinhoney.com/shop/nielsen",
      "store_id": "398791816580311916"
    },
    {
      "country": "US",
      "label": "naked-wardrobe",
      "name": "Naked Wardrobe",
      "shop_url": "https://www.joinhoney.com/shop/naked-wardrobe",
      "store_id": "214984998583157841"
    },
    {
      "country": "US",
      "label": "nine-west",
      "name": "Nine West",
      "shop_url": "https://www.joinhoney.com/shop/nine-west",
      "store_id": "7394093717368591472"
    },
    {
      "country": "US",
      "label": "nikon",
      "name": "Nikon",
      "shop_url": "https://www.joinhoney.com/shop/nikon",
      "store_id": "132"
    }
  ],
  "suggested_queries": [
    "nike socks",
    "nike",
    "nike shoes men",
    "nike shoes",
    "nike shoes women"
  ]
}
```

### Store coupons

- Capability: `coupons/store_coupons`
- Description: Public coupon codes and deals Honey lists for one store, as on its joinhoney.com/shop/<label> page. The store can be a Honey label (kohls, best-buy), a store name (Best Buy), a merchant domain (bestbuy.com, verified against the store's URL) or a joinhoney.com store URL. Each code: code, description, discount, minimum spend, flags (free shipping, sitewide, exclusions), Honey badge, exclusive, uses and last_worked_at; each deal: description, discount and landing URL. Also the store's id, website, average member savings over 30 days and savings found in 24 hours. Honey publishes no expiry dates. 1 to 3 requests.
- Instructions: Promo codes or current deals for a named store or domain. Use search_stores first when the store name is ambiguous.
- Cost: 5 credits per call
- Capability file: [Store coupons](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/store_coupons)

Accepted options:
- `include_deals` (boolean): Also return the store's no-code sales. Default true. Example: `false`
- `store` (string): Honey store label, store name or merchant domain, e.g. kohls, Best Buy or bestbuy.com. Pass this or url. Example: `<store>`
- `url` (string): A joinhoney.com store page URL such as https://www.joinhoney.com/shop/kohls. Pass this or store. Example: `<url>`

Response schema example:
```json
{
  "coupon_count": 20,
  "coupons": [
    {
      "badge": "Popular coupon",
      "code": "SHOP10",
      "created_at": "2026-11-10T10:05:05Z",
      "deal_id": "701846949653908361",
      "description": "Take $10 off $25+ Orders",
      "discount": "$10",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-10T19:17:38Z",
      "minimum_spend": "$25",
      "sitewide": false,
      "starts_at": "2026-11-10T06:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 295
    },
    {
      "badge": "Popular coupon",
      "code": "LOVE2SAVE",
      "created_at": "2026-11-09T08:04:33Z",
      "deal_id": "701655190465190241",
      "description": "Cardholder Event: Kohl's Cardholders Take 30% off or Everyone Take 20% off",
      "discount": "30%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-10T19:17:38Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-11-09T06:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 675
    },
    {
      "badge": "Verified coupon",
      "code": "NOV30",
      "created_at": "2026-11-10T15:06:21Z",
      "deal_id": "701883969148048940",
      "description": "Take an extra 30% off with a Kohl's Card",
      "discount": "30%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-10T19:14:37Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-11-10T15:06:21Z",
      "url": null,
      "uses": 54
    },
    {
      "badge": "Popular coupon",
      "code": "HOME10",
      "created_at": "2026-11-09T10:05:29Z",
      "deal_id": "701670050295261364",
      "description": "Rewards Exclusive: Take $10 off $50+ Home Select Styles",
      "discount": "$10",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-10T19:09:36Z",
      "minimum_spend": "$50",
      "sitewide": false,
      "starts_at": "2026-11-09T06:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 211
    },
    {
      "badge": "Verified coupon",
      "code": "TOYS10",
      "created_at": "2026-11-10T13:01:54Z",
      "deal_id": "701868676398369607",
      "description": "Kohl's Rewards Exclusive: $10 off toys purchase of $50 or more. Excludes baby gear, electronics, novelty gifts, sporting goods and LEGO-branded items. Requires PIN 7514 at checkout.",
      "discount": "$10",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": true,
      "last_worked_at": "2026-11-10T17:25:10Z",
      "minimum_spend": "$50",
      "sitewide": false,
      "starts_at": "2026-11-10T13:01:54Z",
      "url": null,
      "uses": 17
    },
    {
      "badge": "Verified coupon",
      "code": "BIGSAVINGS",
      "created_at": "2026-11-07T13:03:31Z",
      "deal_id": "701338033085392936",
      "description": "Take an extra 20% off. Requires PIN 6023 at checkout.",
      "discount": "20%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-09T04:59:19Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-11-07T13:03:31Z",
      "url": null,
      "uses": 147
    },
    {
      "badge": "Popular coupon",
      "code": "ALLONSALE",
      "created_at": "2026-10-31T13:00:51Z",
      "deal_id": "700099074150652143",
      "description": "Everything is on sale for Sephora Beauty Insiders.",
      "discount": null,
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-10T05:57:19Z",
      "minimum_spend": null,
      "sitewide": true,
      "starts_at": "2026-10-31T13:00:51Z",
      "url": null,
      "uses": 383
    },
    {
      "badge": "Verified coupon",
      "code": "SHOPPER20",
      "created_at": "2025-11-12T16:05:08Z",
      "deal_id": "637659358169606523",
      "description": "20% off in store and online. Requires PIN 9383 at checkout.",
      "discount": "20%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-10-05T02:21:09Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2025-11-12T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 2912
    },
    {
      "badge": "Verified coupon",
      "code": "SHOPNOW20",
      "created_at": "2026-03-06T17:09:39Z",
      "deal_id": "657839266325502879",
      "description": "Take an extra 20% off. Requires PIN 9852.",
      "discount": "20%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-02T06:05:40Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-03-06T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 600
    },
    {
      "badge": "Popular coupon",
      "code": "SCSAVE",
      "created_at": "2025-11-03T17:32:33Z",
      "deal_id": "636077575168235399",
      "description": "30% off Sephora Collection",
      "discount": "30%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-11-10T05:57:19Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2025-11-03T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 500
    },
    {
      "badge": "Verified coupon",
      "code": "EVERYTHING",
      "created_at": "2025-11-03T17:31:58Z",
      "deal_id": "636077503229026036",
      "description": "Beauty Insider promo",
      "discount": null,
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-07-02T17:32:56Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2025-11-03T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 232
    },
    {
      "badge": "Verified coupon",
      "code": "ENJO",
      "created_at": "2025-11-10T17:11:22Z",
      "deal_id": "637313602350839873",
      "description": "Extra 15% Off in Store & Online",
      "discount": "15%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-07-17T18:21:11Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2025-11-10T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 46
    },
    {
      "badge": "Verified coupon",
      "code": "10HOMI",
      "created_at": "2025-11-12T16:04:11Z",
      "deal_id": "637659241553398064",
      "description": "Extra $10 off your $50 home purchase. Kohl's Rewards Member Exclusive. Requires Pin 6842 at checkout.",
      "discount": "$10",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-08-17T02:49:03Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2025-11-12T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 37
    },
    {
      "badge": "Verified coupon",
      "code": "GOSH",
      "created_at": "2025-11-12T16:03:18Z",
      "deal_id": "637659133749795982",
      "description": "Extra $10 off when you spend a minimum of $25. Requires Pin 9775 at checkout.",
      "discount": "$10",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-08-20T18:23:22Z",
      "minimum_spend": "$25",
      "sitewide": false,
      "starts_at": "2025-11-12T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 17
    },
    {
      "badge": "Verified coupon",
      "code": "ONLINE25",
      "created_at": "2026-04-06T21:29:00Z",
      "deal_id": "663356499781941421",
      "description": "Extra 25% off. Online only.",
      "discount": "25%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-08-24T03:13:33Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-04-06T07:00:00Z",
      "url": "https://www.kohls.com",
      "uses": 8
    },
    {
      "badge": "Verified coupon",
      "code": "SHOPP",
      "created_at": "2025-11-12T16:02:20Z",
      "deal_id": "637659014814990388",
      "description": "Extra 20% off in store & online. Requires Pin 9383 at checkout.",
      "discount": "20%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2025-12-21T20:01:52Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2025-11-12T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 6
    },
    {
      "badge": "Verified coupon",
      "code": "MQL9E3F2V7SXU",
      "created_at": "2026-04-27T18:03:05Z",
      "deal_id": "667047087295532704",
      "description": "Kohl's Rewards Exclusive. Extra 30% off. Coupon is valid for one-time use. Ends April 26.",
      "discount": "30%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": "2026-05-11T01:12:24Z",
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-04-27T07:00:00Z",
      "url": "https://www.kohls.com",
      "uses": 1
    },
    {
      "badge": "Verified coupon",
      "code": "HOME",
      "created_at": "2026-02-19T17:23:50Z",
      "deal_id": "655186802369340487",
      "description": "Kohl's Rewards Member Exclusive: Take an Extra 15% Off Home Items. Requires PIN 3055 at Checkout.",
      "discount": "15%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": null,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-02-19T08:00:00Z",
      "url": "https://www.kohls.com/",
      "uses": 0
    },
    {
      "badge": "Verified coupon",
      "code": "INSTA",
      "created_at": "2026-03-17T00:16:47Z",
      "deal_id": "659661224273029202",
      "description": "Get $10 Kohl's Cash to use instantly when you spend $25 or more. Valid for one-time use in store or online. Not valid on Sephora at Kohl's. Requires PIN 5841.",
      "discount": null,
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": true,
      "last_worked_at": null,
      "minimum_spend": "$25",
      "sitewide": false,
      "starts_at": "2026-03-16T07:00:00Z",
      "url": "https://www.kohls.com",
      "uses": 0
    },
    {
      "badge": "Verified coupon",
      "code": "SHOP",
      "created_at": "2026-03-28T00:23:14Z",
      "deal_id": "661608437529389997",
      "description": "Take an extra 15% off. Requires PIN 9250 at checkout.",
      "discount": "15%",
      "exclusive": false,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "last_worked_at": null,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2026-03-27T07:00:00Z",
      "url": "https://www.kohls.com",
      "uses": 0
    }
  ],
  "deal_count": 7,
  "deals": [
    {
      "created_at": "2026-10-28T18:04:52Z",
      "deal_id": "699605591376498361",
      "description": "Extra 40% off When You Apply for the Store Card.",
      "discount": "40%",
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2024-11-08T17:34:00Z",
      "url": "https://www.kohls.com/sale-event/my-kohls-charge.jsp?icid=benefitskccfooter"
    },
    {
      "created_at": "2019-01-02T19:51:27Z",
      "deal_id": "194257485601384661",
      "description": "General Offer",
      "discount": null,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2018-10-31T15:09:26Z",
      "url": "https://www.kohls.com/feature/driveup.jsp?icid=hpmf-driveup"
    },
    {
      "created_at": "2026-11-09T10:05:29Z",
      "deal_id": "701670050313852568",
      "description": "Kohl's Rewards Exclusive: Take $10 off $50+ Select Toys",
      "discount": "$10",
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": "$50",
      "sitewide": false,
      "starts_at": "2026-11-09T06:00:00Z",
      "url": "https://www.kohls.com/"
    },
    {
      "created_at": "2023-03-28T00:38:05Z",
      "deal_id": "467676130228638276",
      "description": "Free Store Pickup. See kohls.com for details.",
      "discount": null,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2023-03-27T07:00:00Z",
      "url": "https://www.kohls.com/"
    },
    {
      "created_at": "2025-01-08T12:10:34Z",
      "deal_id": "583130797280513287",
      "description": "Fast and Free Store Pickup.",
      "discount": null,
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2022-07-18T05:00:00Z",
      "url": "https://www.kohls.com/feature/driveup.jsp?icid=hpmf-driveup"
    },
    {
      "created_at": "2023-03-28T00:37:16Z",
      "deal_id": "467676029126271948",
      "description": "Take an extra 15% off one time only off your next online purchase when you sign up for mobile Sale Alerts. TEXT SAVE24 to 56457 (KOHLS)* TEXT HELP FOR HELP, STOP TO CANCEL.",
      "discount": "15%",
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2023-03-27T07:00:00Z",
      "url": "https://www.kohls.com/"
    },
    {
      "created_at": "2023-03-28T00:37:43Z",
      "deal_id": "467676084778989123",
      "description": "Extra 35% off when you apply for Kohl's Card. See Kohls.com for details.",
      "discount": "35%",
      "first_purchase_only": false,
      "free_shipping": false,
      "has_exclusions": false,
      "minimum_spend": null,
      "sitewide": false,
      "starts_at": "2023-03-27T07:00:00Z",
      "url": "https://www.kohls.com/"
    }
  ],
  "observed_at_ms": 1794340022651,
  "resolved_by": "label",
  "source_url": "https://www.joinhoney.com/shop/kohls",
  "store": {
    "avg_savings_30d_usd": 19.59,
    "country": "US",
    "domain": "kohls.com",
    "label": "kohls",
    "name": "Kohl's",
    "savings_found_24h": 959,
    "shop_url": "https://www.joinhoney.com/shop/kohls",
    "store_id": "112",
    "url": "https://www.kohls.com"
  }
}
```

### Stores on sale

- Capability: `coupons/stores_on_sale`
- Description: Stores Honey currently flags as running a sale, most popular first, with the largest and most common discount and the share of the store's items that are discounted. Pages with continuation. One request.
- Instructions: Discovering which stores have broad sales right now, then pulling details with store_coupons.
- Cost: 5 credits per call
- Capability file: [Stores on sale](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/stores_on_sale)

Accepted options:
- `continuation` (string): Cursor from a previous call's continuation. Example: `<continuation>`
- `country` (string): Two-letter country code (US, CA, GB, AU, ...). Default US. Example: `US`
- `limit` (number): Stores per page. Example: `20`

Response schema example:
```json
{
  "count": 10,
  "country": "US",
  "observed_at_ms": 1794340022670,
  "offset": 0,
  "source_url": "https://d.joinhoney.com/v3?operationName=web_search_storeSales&variables=%7B%22meta%22%3A%7B%22limit%22%3A10%2C%22offset%22%3A0%2C%22sort%22%3A%22POPULARITY%22%2C%22storeCountry%22%3A%22US%22%7D%2C%22query%22%3A%22%22%7D",
  "stores": [
    {
      "discounted_items_percent": 33.8,
      "label": "draper-james",
      "max_discount_percent": 84,
      "name": "Draper James",
      "shop_url": "https://www.joinhoney.com/shop/draper-james",
      "store_id": "96425198672895662",
      "typical_discount_percent": 50
    },
    {
      "discounted_items_percent": 6,
      "label": "woot",
      "max_discount_percent": 92,
      "name": "Woot!",
      "shop_url": "https://www.joinhoney.com/shop/woot",
      "store_id": "7394096567093985904",
      "typical_discount_percent": 61
    },
    {
      "discounted_items_percent": 81.4,
      "label": "allpowers",
      "max_discount_percent": 69,
      "name": "Allpowers",
      "shop_url": "https://www.joinhoney.com/shop/allpowers",
      "store_id": "449145870805375941",
      "typical_discount_percent": 55
    },
    {
      "discounted_items_percent": 56,
      "label": "thefryecompany",
      "max_discount_percent": 87,
      "name": "The Frye Company",
      "shop_url": "https://www.joinhoney.com/shop/thefryecompany",
      "store_id": "7362067005269155372",
      "typical_discount_percent": 58
    },
    {
      "discounted_items_percent": 8.7,
      "label": "mattress-firm",
      "max_discount_percent": 73,
      "name": "Mattress Firm",
      "shop_url": "https://www.joinhoney.com/shop/mattress-firm",
      "store_id": "119771268773749214",
      "typical_discount_percent": 25
    },
    {
      "discounted_items_percent": 41,
      "label": "hobbylobby",
      "max_discount_percent": 75,
      "name": "Hobby Lobby",
      "shop_url": "https://www.joinhoney.com/shop/hobbylobby",
      "store_id": "7360880853639297580",
      "typical_discount_percent": 40
    },
    {
      "discounted_items_percent": 12.9,
      "label": "frames-direct",
      "max_discount_percent": 58,
      "name": "Frames Direct",
      "shop_url": "https://www.joinhoney.com/shop/frames-direct",
      "store_id": "7394091268634269296",
      "typical_discount_percent": 25
    },
    {
      "discounted_items_percent": 62.2,
      "label": "myprotein",
      "max_discount_percent": 96,
      "name": "Myprotein",
      "shop_url": "https://www.joinhoney.com/shop/myprotein",
      "store_id": "7394093574956467824",
      "typical_discount_percent": 40
    },
    {
      "discounted_items_percent": 32.4,
      "label": "tarte-cosmetics",
      "max_discount_percent": 79,
      "name": "tarte cosmetics",
      "shop_url": "https://www.joinhoney.com/shop/tarte-cosmetics",
      "store_id": "7359088609985579308",
      "typical_discount_percent": 59
    },
    {
      "discounted_items_percent": 13.1,
      "label": "onekingslane",
      "max_discount_percent": 90,
      "name": "One Kings Lane",
      "shop_url": "https://www.joinhoney.com/shop/onekingslane",
      "store_id": "7362089221545827116",
      "typical_discount_percent": 30
    }
  ]
}
```

### Top stores

- Capability: `coupons/top_stores`
- Description: Honey's most-shopped stores for a country in Honey's own order, with shoppers in the last 24 hours and 30 days, savings found and average member savings in USD. One request.
- Instructions: Which stores Honey members shop most right now, or a starting list of popular stores to pull coupons for.
- Cost: 5 credits per call
- Capability file: [Top stores](https://alexandria.firecrawl.dev/agents/providers/joinhoney-com/coupons/top_stores)

Accepted options:
- `country` (string): Two-letter country code (US, CA, GB, AU, ...). Default US. Example: `US`
- `limit` (number): Stores to return. Example: `20`

Response schema example:
```json
{
  "count": 10,
  "country": "US",
  "observed_at_ms": 1794340022669,
  "source_url": "https://d.joinhoney.com/v3?operationName=web_getTopStores&variables=%7B%22country%22%3A%22US%22%2C%22limit%22%3A10%7D",
  "stores": [
    {
      "avg_savings_30d_usd": 0,
      "domain": "chatgpt.com",
      "label": "chatgpt",
      "name": "ChatGPT US",
      "rank": 1,
      "savings_found_24h": 0,
      "savings_found_30d": 0,
      "shop_url": "https://www.joinhoney.com/shop/chatgpt",
      "shoppers_24h": 1397801,
      "shoppers_30d": 4948192,
      "store_id": "622802793770236201",
      "url": "https://chatgpt.com/paypal/checkout"
    },
    {
      "avg_savings_30d_usd": 0,
      "domain": "amazon.com",
      "label": "amazon",
      "name": "Amazon",
      "rank": 2,
      "savings_found_24h": 0,
      "savings_found_30d": 0,
      "shop_url": "https://www.joinhoney.com/shop/amazon",
      "shoppers_24h": 908609,
      "shoppers_30d": 4814176,
      "store_id": "1",
      "url": "https://www.amazon.com"
    },
    {
      "avg_savings_30d_usd": 0,
      "domain": "reddit.com",
      "label": "reddit-us",
      "name": "Reddit",
      "rank": 3,
      "savings_found_24h": 0,
      "savings_found_30d": 0,
      "shop_url": "https://www.joinhoney.com/shop/reddit-us",
      "shoppers_24h": 667617,
      "shoppers_30d": 4348618,
      "store_id": "629885000647489067",
      "url": "https://www.reddit.com"
    },
    {
      "avg_savings_30d_usd": 0,
      "domain": "netflix.com",
      "label": "netflix",
      "name": "Netflix",
      "rank": 4,
      "savings_found_24h": 0,
      "savings_found_30d": 0,
      "shop_url": "https://www.joinhoney.com/shop/netflix",
      "shoppers_24h": 390198,
      "shoppers_30d": 2248420,
      "store_id": "7637955791479202445",
      "url": "https://www.netflix.com"
    },
    {
      "avg_savings_30d_usd": 0,
      "domain": "microsoft.com",
      "label": "microsoft-store",
      "name": "Microsoft",
      "rank": 5,
      "savings_found_24h": 0,
      "savings_found_30d": 0,
      "shop_url": "https://www.joinhoney.com/shop/microsoft-store",
      "shoppers_24h": 359389,
      "shoppers_30d": 3620899,
      "store_id": "122",
      "url": "https://www.microsoft.com"
    },
    {
      "avg_savings_30d_usd": 40.76,
      "domain": "shopify.com",
      "label": "shopify",
      "name": "Shopify",
      "rank": 6,
      "savings_found_24h": 0,
      "savings_found_30d": 12,
      "shop_url": "https://www.joinhoney.com/shop/shopify",
      "shoppers_24h": 201729,
      "shoppers_30d": 1694543,
      "store_id": "7360676928657335852",
      "url": "https://www.shopify.com"
    },
    {
      "avg_savings_30d_usd": 1.65,
      "domain": "walmart.com",
      "label": "walmart",
      "name": "Walmart",
      "rank": 7,
      "savings_found_24h": 0,
      "savings_found_30d": 24,
      "shop_url": "https://www.joinhoney.com/shop/walmart",
      "shoppers_24h": 181585,
      "shoppers_30d": 1760994,
      "store_id": "200",
      "url": "https://www.walmart.com/shop/deals"
    },
    {
      "avg_savings_30d_usd": 66.2,
      "domain": "ebay.com",
      "label": "ebay",
      "name": "eBay",
      "rank": 8,
      "savings_found_24h": 4,
      "savings_found_30d": 246,
      "shop_url": "https://www.joinhoney.com/shop/ebay",
      "shoppers_24h": 181125,
      "shoppers_30d": 1521226,
      "store_id": "7357363250899199020",
      "url": "https://www.ebay.com"
    },
    {
      "avg_savings_30d_usd": 18.08,
      "domain": "etsy.com",
      "label": "etsy",
      "name": "Etsy",
      "rank": 9,
      "savings_found_24h": 46,
      "savings_found_30d": 1277,
      "shop_url": "https://www.joinhoney.com/shop/etsy",
      "shoppers_24h": 170095,
      "shoppers_30d": 1631868,
      "store_id": "73",
      "url": "https://www.etsy.com"
    },
    {
      "avg_savings_30d_usd": 0,
      "domain": "disneyplus.com",
      "label": "disney-plus",
      "name": "Disney+",
      "rank": 10,
      "savings_found_24h": 0,
      "savings_found_30d": 0,
      "shop_url": "https://www.joinhoney.com/shop/disney-plus",
      "shoppers_24h": 134103,
      "shoppers_30d": 1048360,
      "store_id": "255108860254316168",
      "url": "https://www.disneyplus.com"
    }
  ]
}
```