---
type: "firecrawl-provider"
description: "Coupons.com (www.coupons.com): the active promo codes and deals the site lists for a store, with the full code, discount badge, expiry, live verification status and last-used time; the editors' top offers of the day; and store search over the site's all-stores directory. Read from the public, server-rendered pages."
use_when: "Coupons.com (www.coupons.com): the active promo codes and deals the site lists for a store, with the full code, discount badge, expiry, live verification status and last-used time; the editors' top offers of the day; and store search over the site's all-stores directory. Read from the public, server-rendered pages."
categories: "Retail"
capabilities: 3
credits_per_call: 5
---
# Coupons.com on Firecrawl Alexandria

Coupons.com (www.coupons.com): the active promo codes and deals the site lists for a store, with the full code, discount badge, expiry, live verification status and last-used time; the editors' top offers of the day; and store search over the site's all-stores directory. Read from the public, server-rendered pages.

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

## More

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

## Capabilities

- [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/coupons-com/coupons/get_store_coupons): The active offers coupons.com lists for one store: promo codes (with the code itself) and no-code deals, each with title, terms, discount badge, start and expiry time, live verification status and when a shopper last used it, plus the site's active-offer count and how many offers were added recently.
- [List top offers](https://alexandria.firecrawl.dev/agents/providers/coupons-com/coupons/list_top_offers): Coupons.com's "Top Offers" (selection of the day): the handful of offers the site's editors feature today, each with title, discount badge, expiry, offer type and the store it belongs to. The page does not show codes; get_store_coupons on the store's slug returns the code.
- [Search stores](https://alexandria.firecrawl.dev/agents/providers/coupons-com/coupons/search_stores): Search the coupons.com all-stores directory (about 1,500 stores) by store name or slug. Returns matching stores with their slug and page URL, exact and prefix matches first.

## 1. Choose this provider when

Coupons.com (www.coupons.com): the active promo codes and deals the site lists for a store, with the full code, discount badge, expiry, live verification status and last-used time; the editors' top offers of the day; and store search over the site's all-stores directory. Read from the public, server-rendered pages.

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

## 3. Add provider options

Use only the options needed for the task:

- `store` (string, required): Store slug as in coupons.com URLs ("target", "walmart", "homedepot") or a pasted store URL such as https://www.coupons.com/coupon-codes/target. Example: `<store>`

## 4. Request through your preferred interface

### JavaScript

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

### Python

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

### cURL

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

### CLI

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


### MCP

Call the FCX MCP retrieve tool with this object:

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

Ask for only the returned fields needed by the task.

## 5. Full request shape

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

## 6. Response data

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

```json
{
  "active_count": 19,
  "codes_count": 3,
  "count": 19,
  "coupons": [
    {
      "code": "SAVE20",
      "description": null,
      "discount": "20% OFF",
      "editors_pick": false,
      "exclusive": false,
      "expires_at": "2026-11-12T04:59:00.000Z",
      "id": "8436b603-6f9d-41e2-856e-c77ba0d80526",
      "last_used_at": "2026-11-10T18:48:13.922Z",
      "starts_at": "2026-07-14T13:53:53.000Z",
      "terms": "This promo code can be used on eligible items. We have checked the promo code at checkout, and the discount is available on select products. Check individual items for discount eligibility. Target may change or discontinue the code at any time, and these terms will be updated as needed.",
      "title": "20% Off Eligible Items with This Target Promo Code",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-03T22:57:32.117Z"
    },
    {
      "code": null,
      "description": null,
      "discount": "$10 OFF",
      "editors_pick": false,
      "exclusive": false,
      "expires_at": "2026-11-18T04:59:59.000Z",
      "id": "247c9687-aba4-4a8d-8b43-759ea254e4cf",
      "last_used_at": "2026-11-10T19:20:49.198Z",
      "starts_at": "2026-08-31T21:04:09.000Z",
      "terms": "Sign in to your Target Circle account to receive up to $10 off select items. Coupons are available for different items, each with its own expiration date. Check the “Coupons to Apply” section to view and apply eligible offers. Offer subject to change or discontinuation at any time without notice by Target.",
      "title": "Get Up to $10 Off in Target Coupon Savings",
      "type": "deal",
      "verified": false,
      "verified_at": null
    },
    {
      "code": "STYLE",
      "description": null,
      "discount": "25% OFF",
      "editors_pick": false,
      "exclusive": false,
      "expires_at": "2026-11-14T03:59:00.000Z",
      "id": "0f667fa3-5a0e-4026-8ecb-acf71a7bc220",
      "last_used_at": "2026-11-10T18:48:43.874Z",
      "starts_at": "2026-07-09T14:08:59.000Z",
      "terms": "This discount applies to qualifying clothing and accessories for women and young women. We have verified that the promo code works at checkout but don't have a complete list of eligible products, so it may not apply to every item in your order. Add the promo code at checkout. Some brands, categories, and clearance items may be excluded. Target may change or discontinue this promo code at any time. These terms will be updated as needed.",
      "title": "25% Off Select Women's Clothing & Accessories with Promo Code",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-03T22:56:09.206Z"
    }
  ],
  "observed_at_ms": 1794339060000,
  "recency": {
    "added_last_month": 0,
    "added_last_week": 2,
    "added_this_month": 13,
    "added_this_week": 11,
    "added_today": 3,
    "added_yesterday": 8
  },
  "source_url": "https://www.coupons.com/coupon-codes/target",
  "store": {
    "name": "Target",
    "retailer_id": "us_7",
    "slug": "target",
    "url": "https://www.coupons.com/coupon-codes/target"
  }
}
```

## 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: The active offers coupons.com lists for one store: promo codes (with the code itself) and no-code deals, each with title, terms, discount badge, start and expiry time, live verification status and when a shopper last used it, plus the site's active-offer count and how many offers were added recently.
- Instructions: Use for promo codes or coupons at a named store. Pass the slug from search_stores when the store's slug is not obvious (e.g. homedepot).
- Cost: 5 credits per call
- Capability file: [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/coupons-com/coupons/get_store_coupons)

Accepted options:
- `store` (string, required): Store slug as in coupons.com URLs ("target", "walmart", "homedepot") or a pasted store URL such as https://www.coupons.com/coupon-codes/target. Example: `<store>`

Response schema example:
```json
{
  "active_count": 19,
  "codes_count": 3,
  "count": 19,
  "coupons": [
    {
      "code": "SAVE20",
      "description": null,
      "discount": "20% OFF",
      "editors_pick": false,
      "exclusive": false,
      "expires_at": "2026-11-12T04:59:00.000Z",
      "id": "8436b603-6f9d-41e2-856e-c77ba0d80526",
      "last_used_at": "2026-11-10T18:48:13.922Z",
      "starts_at": "2026-07-14T13:53:53.000Z",
      "terms": "This promo code can be used on eligible items. We have checked the promo code at checkout, and the discount is available on select products. Check individual items for discount eligibility. Target may change or discontinue the code at any time, and these terms will be updated as needed.",
      "title": "20% Off Eligible Items with This Target Promo Code",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-03T22:57:32.117Z"
    },
    {
      "code": null,
      "description": null,
      "discount": "$10 OFF",
      "editors_pick": false,
      "exclusive": false,
      "expires_at": "2026-11-18T04:59:59.000Z",
      "id": "247c9687-aba4-4a8d-8b43-759ea254e4cf",
      "last_used_at": "2026-11-10T19:20:49.198Z",
      "starts_at": "2026-08-31T21:04:09.000Z",
      "terms": "Sign in to your Target Circle account to receive up to $10 off select items. Coupons are available for different items, each with its own expiration date. Check the “Coupons to Apply” section to view and apply eligible offers. Offer subject to change or discontinuation at any time without notice by Target.",
      "title": "Get Up to $10 Off in Target Coupon Savings",
      "type": "deal",
      "verified": false,
      "verified_at": null
    },
    {
      "code": "STYLE",
      "description": null,
      "discount": "25% OFF",
      "editors_pick": false,
      "exclusive": false,
      "expires_at": "2026-11-14T03:59:00.000Z",
      "id": "0f667fa3-5a0e-4026-8ecb-acf71a7bc220",
      "last_used_at": "2026-11-10T18:48:43.874Z",
      "starts_at": "2026-07-09T14:08:59.000Z",
      "terms": "This discount applies to qualifying clothing and accessories for women and young women. We have verified that the promo code works at checkout but don't have a complete list of eligible products, so it may not apply to every item in your order. Add the promo code at checkout. Some brands, categories, and clearance items may be excluded. Target may change or discontinue this promo code at any time. These terms will be updated as needed.",
      "title": "25% Off Select Women's Clothing & Accessories with Promo Code",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-03T22:56:09.206Z"
    }
  ],
  "observed_at_ms": 1794339060000,
  "recency": {
    "added_last_month": 0,
    "added_last_week": 2,
    "added_this_month": 13,
    "added_this_week": 11,
    "added_today": 3,
    "added_yesterday": 8
  },
  "source_url": "https://www.coupons.com/coupon-codes/target",
  "store": {
    "name": "Target",
    "retailer_id": "us_7",
    "slug": "target",
    "url": "https://www.coupons.com/coupon-codes/target"
  }
}
```

### List top offers

- Capability: `coupons/list_top_offers`
- Description: Coupons.com's "Top Offers" (selection of the day): the handful of offers the site's editors feature today, each with title, discount badge, expiry, offer type and the store it belongs to. The page does not show codes; get_store_coupons on the store's slug returns the code.
- Instructions: Use for today's featured or best coupons across stores when no store is named.
- Cost: 5 credits per call
- Capability file: [List top offers](https://alexandria.firecrawl.dev/agents/providers/coupons-com/coupons/list_top_offers)

Accepted options:

Response schema example:
```json
{
  "count": 7,
  "observed_at_ms": 1794339060000,
  "offers": [
    {
      "discount": "FREE SHIPPING",
      "expires_at": "2027-02-03T04:59:00.000Z",
      "id": "062fca9e-29c3-4890-8e77-d85dc5d7d4ae",
      "store": {
        "name": "Bass Pro Shops",
        "retailer_id": "us_142",
        "slug": "bass-pro-shop",
        "url": "https://www.coupons.com/coupon-codes/bass-pro-shop"
      },
      "title": "Receive Free Shipping on $50+",
      "type": "deal"
    },
    {
      "discount": "10% OFF",
      "expires_at": "2027-01-01T04:59:59.000Z",
      "id": "b4b6dbad-f06b-4413-b639-2143539a0fd3",
      "store": {
        "name": "Lumens",
        "retailer_id": "us_610",
        "slug": "lumens",
        "url": "https://www.coupons.com/coupon-codes/lumens"
      },
      "title": "Use This Exclusive Lumens Coupon Code to Get 10% Off $400+ Orders",
      "type": "code"
    },
    {
      "discount": "FREE ENTREES",
      "expires_at": "2026-11-28T04:59:59.000Z",
      "id": "d88b0702-8d6c-404b-9310-5c1945fa3de5",
      "store": {
        "name": "Topgolf",
        "retailer_id": "us_3044",
        "slug": "topgolf",
        "url": "https://www.coupons.com/coupon-codes/topgolf"
      },
      "title": "Enjoy 1.5 Hours of Play and 2 Free Entrees for $45",
      "type": "code"
    }
  ],
  "source_url": "https://www.coupons.com/selection-of-the-day"
}
```

### Search stores

- Capability: `coupons/search_stores`
- Description: Search the coupons.com all-stores directory (about 1,500 stores) by store name or slug. Returns matching stores with their slug and page URL, exact and prefix matches first.
- Instructions: Resolve a store name to the slug get_store_coupons takes, or check whether coupons.com covers a store.
- Cost: 5 credits per call
- Capability file: [Search stores](https://alexandria.firecrawl.dev/agents/providers/coupons-com/coupons/search_stores)

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

Response schema example:
```json
{
  "count": 1,
  "directory_size": 1534,
  "observed_at_ms": 1794339060000,
  "query": "home depot",
  "source_url": "https://www.coupons.com/coupon-codes",
  "stores": [
    {
      "name": "Home Depot",
      "slug": "homedepot",
      "url": "https://www.coupons.com/coupon-codes/homedepot"
    }
  ],
  "total_matches": 1
}
```