---
type: "firecrawl-provider"
description: "CouponFollow (couponfollow.com): the coupon codes and promotions CouponFollow lists for a store domain, with the code, discount, expiry, shopper verification counts and last-success time; the home page's trending and staff-pick coupons; and coupon lists per shopping category. Read from the public, server-rendered pages."
use_when: "CouponFollow (couponfollow.com): the coupon codes and promotions CouponFollow lists for a store domain, with the code, discount, expiry, shopper verification counts and last-success time; the home page's trending and staff-pick coupons; and coupon lists per shopping category. Read from the public, server-rendered pages."
categories: "Retail"
capabilities: 3
credits_per_call: 5
---
# CouponFollow on Firecrawl Alexandria

CouponFollow (couponfollow.com): the coupon codes and promotions CouponFollow lists for a store domain, with the code, discount, expiry, shopper verification counts and last-success time; the home page's trending and staff-pick coupons; and coupon lists per shopping category. Read from the public, server-rendered pages.

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

## More

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

## Capabilities

- [Get site coupons](https://alexandria.firecrawl.dev/agents/providers/couponfollow-com/coupons/get_site_coupons): The coupons CouponFollow lists for one store, by the store's domain: codes and promotions with title, description, the code, discount, expiry, when a shopper last reported it working, how many shoppers tested it and how many succeeded, plus the store's rating and cashback rate. Expired offers are counted and returned only on request.
- [List category coupons](https://alexandria.firecrawl.dev/agents/providers/couponfollow-com/coupons/list_category_coupons): The coupons CouponFollow lists on a shopping category page (e.g. clothing-accessories, travel, travel/hotels), each with its store domain, code and discount.
- [List trending coupons](https://alexandria.firecrawl.dev/agents/providers/couponfollow-com/coupons/list_trending_coupons): Coupons featured on CouponFollow's home page: the trending list (about 40 offers across stores) or the staff picks, each with its store domain, code, discount and latest recorded checkout saving.

## 1. Choose this provider when

CouponFollow (couponfollow.com): the coupon codes and promotions CouponFollow lists for a store domain, with the code, discount, expiry, shopper verification counts and last-success time; the home page's trending and staff-pick coupons; and coupon lists per shopping category. 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": "couponfollow-com",
  "capability": "coupons/get_site_coupons",
  "options": {
    "domain": "target.com"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `domain` (string, required): Store domain ("target.com"), a store URL, or https://couponfollow.com/site/<domain>. Example: `<domain>`
- `include_expired` (boolean): Also return the expired offers the page lists. Example: `false`

## 4. Request through your preferred interface

### JavaScript

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

### Python

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

### cURL

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

### CLI

```sh
firecrawl scrape 'couponfollow-com/coupons/get_site_coupons' \
  --options '{"domain":"target.com"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "couponfollow-com",
  "capability": "coupons/get_site_coupons",
  "options": {
    "domain": "target.com"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "couponfollow-com",
  "capability": "coupons/get_site_coupons",
  "options": {
    "domain": "target.com"
  }
}
```

## 6. Response data

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

```json
{
  "codes_count": 19,
  "count": 25,
  "expired_count": 5,
  "observed_at_ms": 1794339060000,
  "offers": [
    {
      "code": "SAVE20",
      "code_hint": "E20",
      "created_at": "2014-01-21T05:35:00",
      "description": "By using this Target coupon code when you check out, you can cut up to 20% off your next purchase.",
      "discount": {
        "currency": null,
        "text": "20%",
        "type": "PercentageReduction",
        "value": 20
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C1883877",
      "last_success_at": "2026-11-10T09:12:10",
      "last_verified_at": "2026-04-17T22:30:40",
      "saving": null,
      "store": {
        "domain": "target.com",
        "name": "Target",
        "url": "https://couponfollow.com/site/target.com"
      },
      "title": "Target Discount Code for Up to 20% Off",
      "type": "coupon",
      "url": "https://couponfollow.com/site/target.com#C1883877",
      "user_submitted": false,
      "verification_count": 465,
      "verification_success_count": 8,
      "verified": false
    },
    {
      "code": "STYLE",
      "code_hint": "YLE",
      "created_at": "2015-02-22T22:37:16.577",
      "description": "Enjoy 25% off your Target order with this promo code at checkout, plus extra savings on select items.",
      "discount": {
        "currency": null,
        "text": "25%",
        "type": "PercentageReduction",
        "value": 25
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C2475872",
      "last_success_at": "2026-09-21T10:51:56",
      "last_verified_at": "2026-04-17T22:30:40",
      "saving": null,
      "store": {
        "domain": "target.com",
        "name": "Target",
        "url": "https://couponfollow.com/site/target.com"
      },
      "title": "25% Off at Target + Extra Select Item Savings",
      "type": "coupon",
      "url": "https://couponfollow.com/site/target.com#C2475872",
      "user_submitted": false,
      "verification_count": 57,
      "verification_success_count": 0,
      "verified": false
    },
    {
      "code": null,
      "code_hint": null,
      "created_at": "2026-09-18T15:47:37.907",
      "description": "Get 5% off eligible purchases in stores and online when you pay with a Target Circle Card.",
      "discount": {
        "currency": null,
        "text": "5%",
        "type": "PercentageReduction",
        "value": 5
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": false,
      "id": "P775353",
      "last_success_at": "2026-09-18T15:47:07.907",
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "target.com",
        "name": "Target",
        "url": "https://couponfollow.com/site/target.com"
      },
      "title": "Get 5% Off With Target Circle Card",
      "type": "promotion",
      "url": "https://couponfollow.com/site/target.com#P775353",
      "user_submitted": false,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    }
  ],
  "source_url": "https://couponfollow.com/site/target.com",
  "store": {
    "cashback_rate": "1.5%",
    "domain": "target.com",
    "merchant_id": 3063,
    "name": "Target",
    "rating": {
      "average": 4,
      "votes": 1540
    },
    "url": "https://couponfollow.com/site/target.com"
  }
}
```

## API reference-derived contract

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

### Get site coupons

- Capability: `coupons/get_site_coupons`
- Description: The coupons CouponFollow lists for one store, by the store's domain: codes and promotions with title, description, the code, discount, expiry, when a shopper last reported it working, how many shoppers tested it and how many succeeded, plus the store's rating and cashback rate. Expired offers are counted and returned only on request.
- Instructions: Use for promo codes at a store you can name by domain (target.com, doordash.com). Pass a CouponFollow /site/ URL or a store URL as is.
- Cost: 5 credits per call
- Capability file: [Get site coupons](https://alexandria.firecrawl.dev/agents/providers/couponfollow-com/coupons/get_site_coupons)

Accepted options:
- `domain` (string, required): Store domain ("target.com"), a store URL, or https://couponfollow.com/site/<domain>. Example: `<domain>`
- `include_expired` (boolean): Also return the expired offers the page lists. Example: `false`

Response schema example:
```json
{
  "codes_count": 19,
  "count": 25,
  "expired_count": 5,
  "observed_at_ms": 1794339060000,
  "offers": [
    {
      "code": "SAVE20",
      "code_hint": "E20",
      "created_at": "2014-01-21T05:35:00",
      "description": "By using this Target coupon code when you check out, you can cut up to 20% off your next purchase.",
      "discount": {
        "currency": null,
        "text": "20%",
        "type": "PercentageReduction",
        "value": 20
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C1883877",
      "last_success_at": "2026-11-10T09:12:10",
      "last_verified_at": "2026-04-17T22:30:40",
      "saving": null,
      "store": {
        "domain": "target.com",
        "name": "Target",
        "url": "https://couponfollow.com/site/target.com"
      },
      "title": "Target Discount Code for Up to 20% Off",
      "type": "coupon",
      "url": "https://couponfollow.com/site/target.com#C1883877",
      "user_submitted": false,
      "verification_count": 465,
      "verification_success_count": 8,
      "verified": false
    },
    {
      "code": "STYLE",
      "code_hint": "YLE",
      "created_at": "2015-02-22T22:37:16.577",
      "description": "Enjoy 25% off your Target order with this promo code at checkout, plus extra savings on select items.",
      "discount": {
        "currency": null,
        "text": "25%",
        "type": "PercentageReduction",
        "value": 25
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C2475872",
      "last_success_at": "2026-09-21T10:51:56",
      "last_verified_at": "2026-04-17T22:30:40",
      "saving": null,
      "store": {
        "domain": "target.com",
        "name": "Target",
        "url": "https://couponfollow.com/site/target.com"
      },
      "title": "25% Off at Target + Extra Select Item Savings",
      "type": "coupon",
      "url": "https://couponfollow.com/site/target.com#C2475872",
      "user_submitted": false,
      "verification_count": 57,
      "verification_success_count": 0,
      "verified": false
    },
    {
      "code": null,
      "code_hint": null,
      "created_at": "2026-09-18T15:47:37.907",
      "description": "Get 5% off eligible purchases in stores and online when you pay with a Target Circle Card.",
      "discount": {
        "currency": null,
        "text": "5%",
        "type": "PercentageReduction",
        "value": 5
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": false,
      "id": "P775353",
      "last_success_at": "2026-09-18T15:47:07.907",
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "target.com",
        "name": "Target",
        "url": "https://couponfollow.com/site/target.com"
      },
      "title": "Get 5% Off With Target Circle Card",
      "type": "promotion",
      "url": "https://couponfollow.com/site/target.com#P775353",
      "user_submitted": false,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    }
  ],
  "source_url": "https://couponfollow.com/site/target.com",
  "store": {
    "cashback_rate": "1.5%",
    "domain": "target.com",
    "merchant_id": 3063,
    "name": "Target",
    "rating": {
      "average": 4,
      "votes": 1540
    },
    "url": "https://couponfollow.com/site/target.com"
  }
}
```

### List category coupons

- Capability: `coupons/list_category_coupons`
- Description: The coupons CouponFollow lists on a shopping category page (e.g. clothing-accessories, travel, travel/hotels), each with its store domain, code and discount.
- Instructions: Use for coupons across stores in one category. Root categories: arts-entertainment, business, clothing-accessories, food-gifts, health-beauty, home-garden, life-family, other, sports-fitness, tech-electronics, travel.
- Cost: 5 credits per call
- Capability file: [List category coupons](https://alexandria.firecrawl.dev/agents/providers/couponfollow-com/coupons/list_category_coupons)

Accepted options:
- `category` (string, required): Category slug or path ("travel", "travel/hotels") or a couponfollow.com/category/ URL. Example: `<category>`

Response schema example:
```json
{
  "category": "clothing-accessories",
  "codes_count": 14,
  "count": 15,
  "observed_at_ms": 1794339060000,
  "offers": [
    {
      "code": null,
      "code_hint": null,
      "created_at": null,
      "description": "Save on sale items at Billabong",
      "discount": null,
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": false,
      "id": "P775787",
      "last_success_at": null,
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "billabong.com",
        "name": "Billabong",
        "url": "https://couponfollow.com/site/billabong.com"
      },
      "title": "Shop Items on Sale",
      "type": "featured_promotion",
      "url": "https://couponfollow.com/site/billabong.com#P775787",
      "user_submitted": null,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    },
    {
      "code": "COUPONFOLLOW10",
      "code_hint": "W10",
      "created_at": null,
      "description": "By applying this Princess Polly discount code in checkout, you can enjoy 10% off your next order.",
      "discount": {
        "currency": null,
        "text": "10%",
        "type": "PercentageReduction",
        "value": 10
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C5374500",
      "last_success_at": null,
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "princesspolly.com",
        "name": "Princess Polly",
        "url": "https://couponfollow.com/site/princesspolly.com"
      },
      "title": "Take 10% Off Your Next Princess Polly Order",
      "type": "featured_coupon",
      "url": "https://couponfollow.com/site/princesspolly.com#C5374500",
      "user_submitted": null,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    },
    {
      "code": "WONDER20",
      "code_hint": "R20",
      "created_at": null,
      "description": "Apply this Swarovski promo code during checkout to receive 20% off online day tickets for Swarovski Kristallwelten.",
      "discount": {
        "currency": null,
        "text": "20%",
        "type": "PercentageReduction",
        "value": 20
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C6749735",
      "last_success_at": null,
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "swarovski.com",
        "name": "Swarovski",
        "url": "https://couponfollow.com/site/swarovski.com"
      },
      "title": "Swarovski 20% Off Kristallwelten Day Tickets Promo Code",
      "type": "coupon",
      "url": "https://couponfollow.com/site/swarovski.com#C6749735",
      "user_submitted": null,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    }
  ],
  "source_url": "https://couponfollow.com/category/clothing-accessories"
}
```

### List trending coupons

- Capability: `coupons/list_trending_coupons`
- Description: Coupons featured on CouponFollow's home page: the trending list (about 40 offers across stores) or the staff picks, each with its store domain, code, discount and latest recorded checkout saving.
- Instructions: Use for today's popular or best coupon codes when no store is named.
- Cost: 5 credits per call
- Capability file: [List trending coupons](https://alexandria.firecrawl.dev/agents/providers/couponfollow-com/coupons/list_trending_coupons)

Accepted options:
- `section` (string): Which home page list to return. Example: `trending`

Response schema example:
```json
{
  "codes_count": 36,
  "count": 39,
  "observed_at_ms": 1794339060000,
  "offers": [
    {
      "code": "CFORBPKG35",
      "code_hint": "G35",
      "created_at": null,
      "description": "Use this exclusive CouponFollow code to save $35 on eligible vacation packages of $1,200 or more.",
      "discount": {
        "currency": "USD",
        "text": "$35",
        "type": "MonetaryReduction",
        "value": 35
      },
      "exclusive": true,
      "expired": false,
      "expires_at": null,
      "has_code": true,
      "id": "C6729753",
      "last_success_at": null,
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "orbitz.com",
        "name": "Orbitz",
        "url": "https://couponfollow.com/site/orbitz.com"
      },
      "title": "Save $35 on Orbitz Vacation Packages",
      "type": "featured_coupon",
      "url": "https://couponfollow.com/site/orbitz.com#C6729753",
      "user_submitted": null,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    },
    {
      "code": null,
      "code_hint": null,
      "created_at": null,
      "description": "Save up to 60% off select items plus enjoy free shipping on all orders at Canon during the Black Friday Sale.",
      "discount": {
        "currency": null,
        "text": "60%",
        "type": "PercentageReduction",
        "value": 60
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": false,
      "id": "P776060",
      "last_success_at": null,
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "shop.usa.canon.com",
        "name": "Canon",
        "url": "https://couponfollow.com/site/shop.usa.canon.com"
      },
      "title": "Black Friday Sale! Get Up to 60% Off + Free Shipping",
      "type": "featured_promotion",
      "url": "https://couponfollow.com/site/shop.usa.canon.com#P776060",
      "user_submitted": null,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    },
    {
      "code": null,
      "code_hint": null,
      "created_at": null,
      "description": "Open a TJX rewards credit card and get 10% off your entire purchase.",
      "discount": {
        "currency": null,
        "text": "10%",
        "type": "PercentageReduction",
        "value": 10
      },
      "exclusive": false,
      "expired": false,
      "expires_at": null,
      "has_code": false,
      "id": "P746835",
      "last_success_at": null,
      "last_verified_at": null,
      "saving": null,
      "store": {
        "domain": "marshalls.com",
        "name": "Marshalls",
        "url": "https://couponfollow.com/site/marshalls.com"
      },
      "title": "10% Off Your Order with TJX Rewards Credit Card",
      "type": "featured_promotion",
      "url": "https://couponfollow.com/site/marshalls.com#P746835",
      "user_submitted": null,
      "verification_count": null,
      "verification_success_count": null,
      "verified": false
    }
  ],
  "source_url": "https://couponfollow.com/"
}
```