---
type: "firecrawl-provider"
description: "Promocodes.com (www.promocodes.com) coupon data from the site's embedded page data: a store's active promo codes and deals with the code, savings, verified/exclusive flags, expiry and copies today, plus expired codes and similar stores; store search by name through the API the site's search box calls; the home page's featured and weekly top coupons; and category pages with their coupons, sub-categories and featured stores."
use_when: "Promocodes.com (www.promocodes.com) coupon data from the site's embedded page data: a store's active promo codes and deals with the code, savings, verified/exclusive flags, expiry and copies today, plus expired codes and similar stores; store search by name through the API the site's search box calls; the home page's featured and weekly top coupons; and category pages with their coupons, sub-categories and featured stores."
categories: "Retail"
capabilities: 4
credits_per_call: 5
---
# Promocodes.com coupons and promo codes on Firecrawl Alexandria

Promocodes.com (www.promocodes.com) coupon data from the site's embedded page data: a store's active promo codes and deals with the code, savings, verified/exclusive flags, expiry and copies today, plus expired codes and similar stores; store search by name through the API the site's search box calls; the home page's featured and weekly top coupons; and category pages with their coupons, sub-categories and featured stores.

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

## More

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

## Capabilities

- [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/get_store_coupons): One store's promocodes.com page (/{slug}-coupons): featured and active promo codes and deals with the code (null for deals), headline, description, savings amount, verified/exclusive/free-shipping flags, start and expiry dates and copies today; recently expired offers; the store's category, rating and average savings; similar stores.
- [List category coupons](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/list_category_coupons): A promocodes.com category page (/coupons/{category}, e.g. clothing, travel, black-friday): its coupons and deals across stores, sub-categories with offer counts and featured stores.
- [List top coupons](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/list_top_coupons): The promocodes.com home page's coupon rails: featured codes, this week's top coupons and explore picks across stores, each with its store slug, code, savings and flags, tagged by section.
- [Search stores](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/search_stores): Search promocodes.com stores by name through the store search API the site's search box calls. Returns matching stores with slug, promocodes.com URL, website, coupon count and rank.

## 1. Choose this provider when

Promocodes.com (www.promocodes.com) coupon data from the site's embedded page data: a store's active promo codes and deals with the code, savings, verified/exclusive flags, expiry and copies today, plus expired codes and similar stores; store search by name through the API the site's search box calls; the home page's featured and weekly top coupons; and category pages with their coupons, sub-categories and featured 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": "promocodes-com",
  "capability": "coupons/get_store_coupons",
  "options": {
    "store": "kohls"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `store` (string, required): promocodes.com store slug (kohls, nike, apple-store) or store URL (https://www.promocodes.com/kohls-coupons). Example: `<store>`

## 4. Request through your preferred interface

### JavaScript

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

### Python

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

### cURL

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

### CLI

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


### MCP

Call the FCX MCP retrieve tool with this object:

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

Ask for only the returned fields needed by the task.

## 5. Full request shape

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

## 6. Response data

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

```json
{
  "code_count": 3,
  "count": 17,
  "coupons": [
    {
      "code": "YOUGET20",
      "copied_today": 23,
      "created_at": null,
      "description": "Receive 20% off sitewide orders with this coupon code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5574903,
      "savings": 20,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "20% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "TAKE15",
      "copied_today": 8,
      "created_at": null,
      "description": "Get 15% off sitewide orders with this coupon code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5246923,
      "savings": 15,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "15% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "CATCH15OFF",
      "copied_today": 5,
      "created_at": null,
      "description": "Receive 15% off sitewide orders $100+ with this promo code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5214401,
      "savings": 15,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "15% Off",
      "type": "code",
      "verified": true
    }
  ],
  "expired_coupons": [
    {
      "code": "GET20",
      "copied_today": 1,
      "created_at": null,
      "description": "Enjoy 20% off sitewide orders with this coupon code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-10-31",
      "free_shipping": null,
      "id": 5572614,
      "savings": 20,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "20% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "WOMENS20",
      "copied_today": 1,
      "created_at": null,
      "description": "Get 20% off women's clothing, shoes, & accessories with this promo code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-07-28",
      "free_shipping": null,
      "id": 5335043,
      "savings": 20,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "20% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "HOME15",
      "copied_today": 1,
      "created_at": null,
      "description": "Reveal this Kohl's promo code to Save  15% off select Home",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-03-02",
      "free_shipping": null,
      "id": 5167428,
      "savings": 15,
      "savings_is_range": true,
      "starts_at": "2026-02-17",
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "15% off select Home",
      "type": "code",
      "verified": true
    }
  ],
  "observed_at_ms": 1794340352788,
  "similar_stores": [
    {
      "name": "Charming Charlie",
      "slug": "charming-charlie",
      "url": "https://www.promocodes.com/charming-charlie-coupons"
    },
    {
      "name": "Lord and Taylor",
      "slug": "lord-and-taylor",
      "url": "https://www.promocodes.com/lord-and-taylor-coupons"
    },
    {
      "name": "LOFT",
      "slug": "loft",
      "url": "https://www.promocodes.com/loft-coupons"
    }
  ],
  "source_url": "https://www.promocodes.com/kohls-coupons",
  "store": {
    "average_savings": 111,
    "category": {
      "name": "Department Stores",
      "slug": "department-stores"
    },
    "id": 21689,
    "logo_url": "https://cdn.discountcodes.com/img/merchants/288/120-logo/v3/kohls-coupons.jpg",
    "name": "Kohl's",
    "rating": 4.6,
    "rating_count": 191,
    "slug": "kohls",
    "updated_at": "2026-11-06T16:34:26.281924Z",
    "url": "https://www.promocodes.com/kohls-coupons"
  },
  "title": "20% OFF Kohl's Promo Codes & Coupons (Nov 2026)"
}
```

## 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 promocodes.com page (/{slug}-coupons): featured and active promo codes and deals with the code (null for deals), headline, description, savings amount, verified/exclusive/free-shipping flags, start and expiry dates and copies today; recently expired offers; the store's category, rating and average savings; similar stores.
- Instructions: When the user wants coupons or promo codes for a named store. Pass the store slug (kohls) or a promocodes.com store URL; call search_stores first when you only have the store's name.
- Cost: 5 credits per call
- Capability file: [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/get_store_coupons)

Accepted options:
- `store` (string, required): promocodes.com store slug (kohls, nike, apple-store) or store URL (https://www.promocodes.com/kohls-coupons). Example: `<store>`

Response schema example:
```json
{
  "code_count": 3,
  "count": 17,
  "coupons": [
    {
      "code": "YOUGET20",
      "copied_today": 23,
      "created_at": null,
      "description": "Receive 20% off sitewide orders with this coupon code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5574903,
      "savings": 20,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "20% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "TAKE15",
      "copied_today": 8,
      "created_at": null,
      "description": "Get 15% off sitewide orders with this coupon code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5246923,
      "savings": 15,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "15% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "CATCH15OFF",
      "copied_today": 5,
      "created_at": null,
      "description": "Receive 15% off sitewide orders $100+ with this promo code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5214401,
      "savings": 15,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "15% Off",
      "type": "code",
      "verified": true
    }
  ],
  "expired_coupons": [
    {
      "code": "GET20",
      "copied_today": 1,
      "created_at": null,
      "description": "Enjoy 20% off sitewide orders with this coupon code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-10-31",
      "free_shipping": null,
      "id": 5572614,
      "savings": 20,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "20% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "WOMENS20",
      "copied_today": 1,
      "created_at": null,
      "description": "Get 20% off women's clothing, shoes, & accessories with this promo code at Kohl's.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-07-28",
      "free_shipping": null,
      "id": 5335043,
      "savings": 20,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "20% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "HOME15",
      "copied_today": 1,
      "created_at": null,
      "description": "Reveal this Kohl's promo code to Save  15% off select Home",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-03-02",
      "free_shipping": null,
      "id": 5167428,
      "savings": 15,
      "savings_is_range": true,
      "starts_at": "2026-02-17",
      "store": {
        "id": 21689,
        "name": "Kohl's",
        "slug": "kohls",
        "url": "https://www.promocodes.com/kohls-coupons"
      },
      "title": "15% off select Home",
      "type": "code",
      "verified": true
    }
  ],
  "observed_at_ms": 1794340352788,
  "similar_stores": [
    {
      "name": "Charming Charlie",
      "slug": "charming-charlie",
      "url": "https://www.promocodes.com/charming-charlie-coupons"
    },
    {
      "name": "Lord and Taylor",
      "slug": "lord-and-taylor",
      "url": "https://www.promocodes.com/lord-and-taylor-coupons"
    },
    {
      "name": "LOFT",
      "slug": "loft",
      "url": "https://www.promocodes.com/loft-coupons"
    }
  ],
  "source_url": "https://www.promocodes.com/kohls-coupons",
  "store": {
    "average_savings": 111,
    "category": {
      "name": "Department Stores",
      "slug": "department-stores"
    },
    "id": 21689,
    "logo_url": "https://cdn.discountcodes.com/img/merchants/288/120-logo/v3/kohls-coupons.jpg",
    "name": "Kohl's",
    "rating": 4.6,
    "rating_count": 191,
    "slug": "kohls",
    "updated_at": "2026-11-06T16:34:26.281924Z",
    "url": "https://www.promocodes.com/kohls-coupons"
  },
  "title": "20% OFF Kohl's Promo Codes & Coupons (Nov 2026)"
}
```

### List category coupons

- Capability: `coupons/list_category_coupons`
- Description: A promocodes.com category page (/coupons/{category}, e.g. clothing, travel, black-friday): its coupons and deals across stores, sub-categories with offer counts and featured stores.
- Instructions: When the user asks for coupons in a product category or a seasonal event rather than a store.
- Cost: 5 credits per call
- Capability file: [List category coupons](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/list_category_coupons)

Accepted options:
- `category` (string, required): Category slug as in the site's URLs (clothing, travel, black-friday) or a promocodes.com /coupons/<slug> URL. Example: `<category>`

Response schema example:
```json
{
  "category": {
    "name": "Clothing",
    "offer_count": 1019,
    "slug": "clothing"
  },
  "count": 47,
  "coupons": [
    {
      "code": "GETSOMEASS",
      "copied_today": 1,
      "created_at": "2025-09-09T16:24:09.099653Z",
      "description": "Grab 10% off sitewide orders with this coupon code at Worldclass Clothing.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": false,
      "id": 5027711,
      "savings": 10,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 122976,
        "name": "Worldclass Clothing",
        "slug": "worldclassclothing",
        "url": "https://www.promocodes.com/worldclassclothing-coupons"
      },
      "title": "10% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": null,
      "copied_today": 0,
      "created_at": "2024-05-29T14:39:30.537075Z",
      "description": "Take advantage of up to 65% off clearance items at Dickies with this fantastic offer!",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": false,
      "id": 5457002,
      "savings": 65,
      "savings_is_range": true,
      "starts_at": "2024-05-29",
      "store": {
        "id": 21949,
        "name": "Dickies",
        "slug": "dickies",
        "url": "https://www.promocodes.com/dickies-coupons"
      },
      "title": "Clearance: Up to 65% Off",
      "type": "deal",
      "verified": false
    },
    {
      "code": "EXTRA30",
      "copied_today": 2,
      "created_at": "2025-04-25T15:06:46.458074Z",
      "description": "Enjoy an extra 30% off select orders with this coupon code at Mango Outlet.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": false,
      "id": 4928508,
      "savings": 30,
      "savings_is_range": false,
      "starts_at": null,
      "store": {
        "id": 117720,
        "name": "Mango Outlet",
        "slug": "mangooutlet",
        "url": "https://www.promocodes.com/mangooutlet-coupons"
      },
      "title": "30% Off",
      "type": "code",
      "verified": true
    }
  ],
  "observed_at_ms": 1794340352819,
  "source_url": "https://www.promocodes.com/coupons/clothing",
  "stores": [
    {
      "name": "Worldclass Clothing",
      "slug": "worldclassclothing",
      "url": "https://www.promocodes.com/worldclassclothing-coupons"
    },
    {
      "name": "Next",
      "slug": "next",
      "url": "https://www.promocodes.com/next-coupons"
    },
    {
      "name": "Mango Outlet",
      "slug": "mangooutlet",
      "url": "https://www.promocodes.com/mangooutlet-coupons"
    }
  ],
  "sub_categories": [
    {
      "name": "Designer Clothing",
      "offer_count": 455,
      "slug": "designer-clothing",
      "url": "https://www.promocodes.com/coupons/designer-clothing"
    },
    {
      "name": "Jeans & Denim",
      "offer_count": 305,
      "slug": "jeans",
      "url": "https://www.promocodes.com/coupons/jeans"
    },
    {
      "name": "Alternative Apparel",
      "offer_count": 51,
      "slug": "alternative-apparel",
      "url": "https://www.promocodes.com/coupons/alternative-apparel"
    }
  ],
  "title": "Clothing Deals and Promo Codes | Nov 2026"
}
```

### List top coupons

- Capability: `coupons/list_top_coupons`
- Description: The promocodes.com home page's coupon rails: featured codes, this week's top coupons and explore picks across stores, each with its store slug, code, savings and flags, tagged by section.
- Instructions: For trending or popular promo codes without a specific store.
- Cost: 5 credits per call
- Capability file: [List top coupons](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/list_top_coupons)

Accepted options:

Response schema example:
```json
{
  "count": 110,
  "coupons": [
    {
      "code": "PCODES32",
      "copied_today": 15,
      "created_at": null,
      "description": "Promocodes.com Exclusive! Reveal this Dutch Pet promo code to receive 32% off your purchase.",
      "exclusions": null,
      "exclusive": true,
      "expires_at": "2026-12-31",
      "free_shipping": null,
      "id": 5410921,
      "savings": 32,
      "savings_is_range": false,
      "section": "featured",
      "starts_at": null,
      "store": {
        "id": 35434,
        "name": "Dutch Pet",
        "slug": "dutch-pet",
        "url": "https://www.promocodes.com/dutch-pet-coupons"
      },
      "title": "32% off Exclusive Code",
      "type": "code",
      "verified": true
    },
    {
      "code": "LAW001010",
      "copied_today": 5,
      "created_at": null,
      "description": "Get 10% off Will Estate Plan Basic at LegalZoom with this promo code.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": null,
      "free_shipping": null,
      "id": 5084575,
      "savings": 10,
      "savings_is_range": false,
      "section": "featured",
      "starts_at": null,
      "store": {
        "id": 22124,
        "name": "LegalZoom",
        "slug": "legalzoom",
        "url": "https://www.promocodes.com/legalzoom-coupons"
      },
      "title": "10% Off",
      "type": "code",
      "verified": true
    },
    {
      "code": "BLACK",
      "copied_today": 1,
      "created_at": null,
      "description": "Black Friday! Apply this limited-time coupon code to receive 50% off on your entire purchase at GLD.",
      "exclusions": null,
      "exclusive": false,
      "expires_at": "2026-12-06",
      "free_shipping": null,
      "id": 5601651,
      "savings": 50,
      "savings_is_range": false,
      "section": "featured",
      "starts_at": "2026-11-03",
      "store": {
        "id": 26883,
        "name": "GLD",
        "slug": "the-gld-shop",
        "url": "https://www.promocodes.com/the-gld-shop-coupons"
      },
      "title": "Save 50% Sitewide",
      "type": "code",
      "verified": false
    }
  ],
  "observed_at_ms": 1794340352805,
  "source_url": "https://www.promocodes.com/"
}
```

### Search stores

- Capability: `coupons/search_stores`
- Description: Search promocodes.com stores by name through the store search API the site's search box calls. Returns matching stores with slug, promocodes.com URL, website, coupon count and rank.
- Instructions: To find the store slug for get_store_coupons when the user names a store.
- Cost: 5 credits per call
- Capability file: [Search stores](https://alexandria.firecrawl.dev/agents/providers/promocodes-com/coupons/search_stores)

Accepted options:
- `query` (string, required): Store name or part of it, e.g. nike. Example: `<query>`

Response schema example:
```json
{
  "count": 2,
  "observed_at_ms": 1794340352820,
  "query": "nike",
  "source_url": "https://backend.discountcodes.com/api/v1/stores/search-stores/?search_text=nike&client=8",
  "stores": [
    {
      "coupon_count": 9,
      "id": 22133,
      "logo_url": "https://cdn.discountcodes.com/img/merchants/1760/120-logo/v6/nike-coupons.png",
      "name": "Nike",
      "rank": "Super",
      "slug": "nike",
      "updated_at": "2026-11-07T04:36:51.927972Z",
      "url": "https://www.promocodes.com/nike-coupons",
      "website": "https://www.nike.com/us/en_us/"
    },
    {
      "coupon_count": 5,
      "id": 133222,
      "logo_url": "https://res.cloudinary.com/discountcodes/image/upload/c_fit,w_360,h_120/v1782125667/store_logos/nikestrength-coupons-v1782125671265.png",
      "name": "Nike Strength",
      "rank": "Runner-up",
      "slug": "nikestrength",
      "updated_at": "2026-10-07T14:31:37.172382Z",
      "url": "https://www.promocodes.com/nikestrength-coupons",
      "website": "https://nikestrength.com"
    }
  ]
}
```