---
type: "firecrawl-provider"
description: "Savings.com (www.savings.com) coupon and promo code pages: a store's active codes and deals by its domain, with the revealed code, discount, offer category, expiry, 'used N times' counter and exclusive/top-deal flags, plus its recently expired codes; the site's hot coupons home; and category listings across stores."
use_when: "Savings.com (www.savings.com) coupon and promo code pages: a store's active codes and deals by its domain, with the revealed code, discount, offer category, expiry, 'used N times' counter and exclusive/top-deal flags, plus its recently expired codes; the site's hot coupons home; and category listings across stores."
categories: "Retail"
capabilities: 3
credits_per_call: 5
---
# Savings.com coupons and promo codes on Firecrawl Alexandria

Savings.com (www.savings.com) coupon and promo code pages: a store's active codes and deals by its domain, with the revealed code, discount, offer category, expiry, 'used N times' counter and exclusive/top-deal flags, plus its recently expired codes; the site's hot coupons home; and category listings across stores.

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

## More

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

## Capabilities

- [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/savings-com/coupons/get_store_coupons): One store's savings.com page (/coupons/<domain>): every active promo code and deal with the code itself (null for deals), discount badge, offer category, details, expiry date, 'used N times' counter, exclusive/top-deal/free-shipping flags and an anchored source URL, plus the store's name, website and rating and the page's recently expired codes.
- [List category coupons](https://alexandria.firecrawl.dev/agents/providers/savings-com/coupons/list_category_coupons): A savings.com category page (/coupons/<category>, e.g. electronics, clothing, travel): the category's featured codes and deals across stores with store domain, code, usage counter and flags.
- [List hot coupons](https://alexandria.firecrawl.dev/agents/providers/savings-com/coupons/list_hot_coupons): The savings.com coupons home (/coupons): the site's current hot and popular codes and deals across stores, each with its store domain, revealed code, usage counter and flags.

## 1. Choose this provider when

Savings.com (www.savings.com) coupon and promo code pages: a store's active codes and deals by its domain, with the revealed code, discount, offer category, expiry, 'used N times' counter and exclusive/top-deal flags, plus its recently expired codes; the site's hot coupons home; and category listings across stores.

## 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": "savings-com",
  "capability": "coupons/get_store_coupons",
  "options": {
    "store": "eyebuydirect.com"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `store` (string, required): Store domain (kohls.com), store website URL (https://www.kohls.com/) or savings.com store URL (https://www.savings.com/coupons/kohls.com). Example: `<store>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "savings-com",
    capability: "coupons/get_store_coupons",
    options: {
      store: "eyebuydirect.com",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "savings-com",
  "capability": "coupons/get_store_coupons",
  "options": {
    "store": "eyebuydirect.com"
  }
})
```

### cURL

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

### CLI

```sh
firecrawl scrape 'savings-com/coupons/get_store_coupons' \
  --options '{"store":"eyebuydirect.com"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "savings-com",
  "capability": "coupons/get_store_coupons",
  "options": {
    "store": "eyebuydirect.com"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "savings-com",
  "capability": "coupons/get_store_coupons",
  "options": {
    "store": "eyebuydirect.com"
  }
}
```

## 6. Response data

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

```json
{
  "code_count": 20,
  "count": 32,
  "coupons": [
    {
      "badges": [
        "TOP DEAL"
      ],
      "category": "Discount",
      "code": "GET45",
      "details": "The offer is only available for new customers. Need to log in to the account.",
      "discount": "45% Off",
      "exclusive": false,
      "expires_at": "2026-12-31",
      "expires_text": null,
      "free_shipping": false,
      "id": "10666005",
      "offer_id": "15315798",
      "store_domain": "eyebuydirect.com",
      "store_name": "EyeBuyDirect",
      "title": "45% Off Your Order",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/eyebuydirect.com#d-10666005",
      "used_count": 3920
    },
    {
      "badges": [
        "TOP DEAL"
      ],
      "category": "Discount",
      "code": "20FORU",
      "details": null,
      "discount": "20% Off",
      "exclusive": false,
      "expires_at": "2026-12-31",
      "expires_text": null,
      "free_shipping": false,
      "id": "10666007",
      "offer_id": "15315800",
      "store_domain": "eyebuydirect.com",
      "store_name": "EyeBuyDirect",
      "title": "20% Off Your Order",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/eyebuydirect.com#d-10666007",
      "used_count": 294
    },
    {
      "badges": [
        "TOP DEAL"
      ],
      "category": "Discount",
      "code": "KODAK50",
      "details": null,
      "discount": "50% Off",
      "exclusive": false,
      "expires_at": "2026-11-16",
      "expires_text": "Expires in 1 week",
      "free_shipping": false,
      "id": "10938181",
      "offer_id": "15590415",
      "store_domain": "eyebuydirect.com",
      "store_name": "EyeBuyDirect",
      "title": "50% Off Kodak Lenses",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/eyebuydirect.com#d-10938181",
      "used_count": 162
    }
  ],
  "expired_coupons": [
    {
      "code": "SAVEALOT",
      "offer_id": "15625953",
      "title": "Buy 1, Get 1 75% Off Your Order"
    },
    {
      "code": "UP40",
      "offer_id": "15602404",
      "title": "40% Off Orders Over $160"
    }
  ],
  "observed_at_ms": 1794339697118,
  "page_title": "EyeBuyDirect coupons - 60% off in November 2026",
  "source_url": "https://www.savings.com/coupons/eyebuydirect.com",
  "store": {
    "description": "EyeBuyDirect is an affordable online eyewear retailer. The company sells in-house prescription and non-prescription glasses, sunglasses, and glare-reducing glasses for men, women, and children. Discover all the most prestigious brands in EyeBuyDirect’s catalog and use our coupons and deals to save on your eyewear.",
    "domain": "eyebuydirect.com",
    "logo_url": "https://cdn.sdccdn.com/images/savings/logo/5152280.png?width=125&height=125",
    "name": "EyeBuyDirect",
    "rating": 5,
    "rating_count": 9,
    "website": "https://www.eyebuydirect.com/"
  },
  "updated_at": "2026-11-09T08:02:42-0800"
}
```

## API reference-derived contract

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

### Get store coupons

- Capability: `coupons/get_store_coupons`
- Description: One store's savings.com page (/coupons/<domain>): every active promo code and deal with the code itself (null for deals), discount badge, offer category, details, expiry date, 'used N times' counter, exclusive/top-deal/free-shipping flags and an anchored source URL, plus the store's name, website and rating and the page's recently expired codes.
- Instructions: When the user names a store or retailer domain and wants its coupons or promo codes. Pass a domain (kohls.com), the store's website URL or a savings.com store URL.
- Cost: 5 credits per call
- Capability file: [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/savings-com/coupons/get_store_coupons)

Accepted options:
- `store` (string, required): Store domain (kohls.com), store website URL (https://www.kohls.com/) or savings.com store URL (https://www.savings.com/coupons/kohls.com). Example: `<store>`

Response schema example:
```json
{
  "code_count": 20,
  "count": 32,
  "coupons": [
    {
      "badges": [
        "TOP DEAL"
      ],
      "category": "Discount",
      "code": "GET45",
      "details": "The offer is only available for new customers. Need to log in to the account.",
      "discount": "45% Off",
      "exclusive": false,
      "expires_at": "2026-12-31",
      "expires_text": null,
      "free_shipping": false,
      "id": "10666005",
      "offer_id": "15315798",
      "store_domain": "eyebuydirect.com",
      "store_name": "EyeBuyDirect",
      "title": "45% Off Your Order",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/eyebuydirect.com#d-10666005",
      "used_count": 3920
    },
    {
      "badges": [
        "TOP DEAL"
      ],
      "category": "Discount",
      "code": "20FORU",
      "details": null,
      "discount": "20% Off",
      "exclusive": false,
      "expires_at": "2026-12-31",
      "expires_text": null,
      "free_shipping": false,
      "id": "10666007",
      "offer_id": "15315800",
      "store_domain": "eyebuydirect.com",
      "store_name": "EyeBuyDirect",
      "title": "20% Off Your Order",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/eyebuydirect.com#d-10666007",
      "used_count": 294
    },
    {
      "badges": [
        "TOP DEAL"
      ],
      "category": "Discount",
      "code": "KODAK50",
      "details": null,
      "discount": "50% Off",
      "exclusive": false,
      "expires_at": "2026-11-16",
      "expires_text": "Expires in 1 week",
      "free_shipping": false,
      "id": "10938181",
      "offer_id": "15590415",
      "store_domain": "eyebuydirect.com",
      "store_name": "EyeBuyDirect",
      "title": "50% Off Kodak Lenses",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/eyebuydirect.com#d-10938181",
      "used_count": 162
    }
  ],
  "expired_coupons": [
    {
      "code": "SAVEALOT",
      "offer_id": "15625953",
      "title": "Buy 1, Get 1 75% Off Your Order"
    },
    {
      "code": "UP40",
      "offer_id": "15602404",
      "title": "40% Off Orders Over $160"
    }
  ],
  "observed_at_ms": 1794339697118,
  "page_title": "EyeBuyDirect coupons - 60% off in November 2026",
  "source_url": "https://www.savings.com/coupons/eyebuydirect.com",
  "store": {
    "description": "EyeBuyDirect is an affordable online eyewear retailer. The company sells in-house prescription and non-prescription glasses, sunglasses, and glare-reducing glasses for men, women, and children. Discover all the most prestigious brands in EyeBuyDirect’s catalog and use our coupons and deals to save on your eyewear.",
    "domain": "eyebuydirect.com",
    "logo_url": "https://cdn.sdccdn.com/images/savings/logo/5152280.png?width=125&height=125",
    "name": "EyeBuyDirect",
    "rating": 5,
    "rating_count": 9,
    "website": "https://www.eyebuydirect.com/"
  },
  "updated_at": "2026-11-09T08:02:42-0800"
}
```

### List category coupons

- Capability: `coupons/list_category_coupons`
- Description: A savings.com category page (/coupons/<category>, e.g. electronics, clothing, travel): the category's featured codes and deals across stores with store domain, code, usage counter and flags.
- Instructions: When the user asks for coupons in a product category rather than a store.
- Cost: 5 credits per call
- Capability file: [List category coupons](https://alexandria.firecrawl.dev/agents/providers/savings-com/coupons/list_category_coupons)

Accepted options:
- `category` (string, required): Category slug as in the site's URLs (electronics, clothing, home-and-garden) or a savings.com category URL. Example: `<category>`

Response schema example:
```json
{
  "category": "electronics",
  "count": 20,
  "coupons": [
    {
      "badges": [],
      "category": null,
      "code": null,
      "details": null,
      "discount": null,
      "exclusive": false,
      "expires_at": null,
      "expires_text": null,
      "free_shipping": false,
      "id": "10529382",
      "offer_id": null,
      "store_domain": "qvc.com",
      "store_name": "QVC",
      "title": "Up to 77% Off Clearance Items",
      "top_deal": true,
      "type": "deal",
      "url": "https://www.savings.com/coupons/qvc.com#d-10529382",
      "used_count": 257
    },
    {
      "badges": [],
      "category": null,
      "code": null,
      "details": null,
      "discount": null,
      "exclusive": false,
      "expires_at": null,
      "expires_text": null,
      "free_shipping": false,
      "id": "7373301",
      "offer_id": null,
      "store_domain": "bestbuy.com",
      "store_name": "Best Buy",
      "title": "Up to 60% Off Outlet Deals",
      "top_deal": true,
      "type": "deal",
      "url": "https://www.savings.com/coupons/bestbuy.com#d-7373301",
      "used_count": 24868
    },
    {
      "badges": [],
      "category": null,
      "code": null,
      "details": null,
      "discount": null,
      "exclusive": false,
      "expires_at": null,
      "expires_text": null,
      "free_shipping": false,
      "id": "9858094",
      "offer_id": null,
      "store_domain": "walmart.com",
      "store_name": "Walmart",
      "title": "Up to 65% Off Flash Deals",
      "top_deal": true,
      "type": "deal",
      "url": "https://www.savings.com/coupons/walmart.com#d-9858094",
      "used_count": 4305
    }
  ],
  "observed_at_ms": 1794339697291,
  "source_url": "https://www.savings.com/coupons/electronics",
  "title": "Best Electronics Coupons Available November 2026"
}
```

### List hot coupons

- Capability: `coupons/list_hot_coupons`
- Description: The savings.com coupons home (/coupons): the site's current hot and popular codes and deals across stores, each with its store domain, revealed code, usage counter and flags.
- Instructions: For trending or today's best coupon codes without a specific store. Follow store_domain into get_store_coupons for that store's full list.
- Cost: 5 credits per call
- Capability file: [List hot coupons](https://alexandria.firecrawl.dev/agents/providers/savings-com/coupons/list_hot_coupons)

Accepted options:

Response schema example:
```json
{
  "category": null,
  "count": 12,
  "coupons": [
    {
      "badges": [],
      "category": null,
      "code": null,
      "details": null,
      "discount": null,
      "exclusive": false,
      "expires_at": null,
      "expires_text": null,
      "free_shipping": false,
      "id": "7305351",
      "offer_id": "11872465",
      "store_domain": "homedepot.com",
      "store_name": "Home Depot",
      "title": "Up to 35% Off Home Depot Deal of the Day",
      "top_deal": true,
      "type": "deal",
      "url": "https://www.savings.com/coupons/homedepot.com#d-7305351",
      "used_count": 1698891
    },
    {
      "badges": [],
      "category": null,
      "code": null,
      "details": null,
      "discount": null,
      "exclusive": false,
      "expires_at": null,
      "expires_text": null,
      "free_shipping": false,
      "id": "9209989",
      "offer_id": "13847701",
      "store_domain": "macys.com",
      "store_name": "Macy's",
      "title": "25% Off With Macy's Email Sign Up",
      "top_deal": true,
      "type": "deal",
      "url": "https://www.savings.com/coupons/macys.com#d-9209989",
      "used_count": 1335603
    },
    {
      "badges": [],
      "category": null,
      "code": "20HOLI",
      "details": null,
      "discount": null,
      "exclusive": false,
      "expires_at": null,
      "expires_text": null,
      "free_shipping": false,
      "id": "10966858",
      "offer_id": "15619366",
      "store_domain": "harryanddavid.com",
      "store_name": "Harry & David",
      "title": "20% Off Sitewide",
      "top_deal": true,
      "type": "code",
      "url": "https://www.savings.com/coupons/harryanddavid.com#d-10966858",
      "used_count": 2366
    }
  ],
  "observed_at_ms": 1794339697238,
  "source_url": "https://www.savings.com/coupons",
  "title": "Online Coupons and Deals"
}
```