# CouponFollow Coupon Listing Scraper (`ecomscrape/couponfollow-coupon-listing-scraper`) Actor

Extract coupon codes, store details, and discount information from CouponFollow.com with this powerful scraper. Access real-time deals from 4,000+ merchants automatically.

- **URL**: https://apify.com/ecomscrape/couponfollow-coupon-listing-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Security:** Full permissions
- **Stats:** 71 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## What does Couponfollow Coupon List Scraper do?

### Introduction

CouponFollow is a real-time coupon code search engine and directory that helps millions of consumers save money each month, serving as an online coupon aggregator for 4,000+ stores. For businesses, marketers, and deal aggregators, accessing this wealth of coupon data manually is time-consuming and inefficient. The CouponFollow Coupon List Scraper addresses this challenge by automating the extraction of comprehensive coupon data from the platform's extensive database.

With 10 million monthly users and helping shoppers save over $400 million dollars, CouponFollow represents one of the most valuable sources of retail discount information available online. This scraper enables users to harness this data for competitive analysis, market research, affiliate marketing, or building their own coupon platforms.

### Scraper Overview

The CouponFollow Coupon List Scraper is designed to extract detailed coupon information from CouponFollow's featured merchant pages and specific store pages. This powerful tool automatically navigates through the platform's structure to collect real-time discount data, store information, and promotional details.

The scraper excels at handling CouponFollow's dynamic content loading and can process multiple URLs simultaneously while respecting the platform's structure. It's particularly valuable for e-commerce professionals, affiliate marketers, price comparison services, and businesses conducting competitive research on discount strategies.

Target users include digital marketing agencies, coupon aggregation platforms, retail analysts, and businesses looking to monitor competitor promotional activities or build comprehensive deal databases.

### Input and Output Details

Example url 1: https://couponfollow.com/featured

Example url 2: https://couponfollow.com/site/amazon.ca

Example url 3: https://couponfollow.com/site/advanceautoparts.com#C6108363

Example Screenshot of coupon list page:

![](https://i.ibb.co/VQ4Zxz9/Screenshot-from-2025-01-24-01-54-09.png)

#### Input Format

The scraper accepts a JSON configuration that allows precise control over the data collection process:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20,
  "urls": [ // Links to coupon list pages.
    "https://couponfollow.com/featured",
    "https://couponfollow.com/site/amazon.ca",
    "https://couponfollow.com/site/advanceautoparts.com#C6108363"
  ]
}
```

**Input Parameters Explained:**

- **max_retries_per_url**: Controls retry attempts for failed requests (recommended: 2-3)
- **proxy**: Residential proxies prevent bot detection; country selection should match target market
- **max_items_per_url**: Limits extracted items per page to manage processing time
- **urls**: Accepts both featured merchant pages and specific store pages

#### Output Format

The scraper returns structured data with the following fields:

```json
[ // List of coupon information
  {
    "store_logo": "https://static.couponfollow.com/aliexpress-com/logo.jpg",
    "title": "Save $4 with AliExpress Promo Code",
    "description": "New AliExpress customers can receive $4 off orders of $10 or more when this coupon code is applied at checkout.",
    "store_url": "https://couponfollow.com/site/aliexpress.com",
    "store_name": "AliExpress",
    "discount_txt": null,
    "code": "OFF",
    "code_url": "https://click.couponfollow.com/click?pwk=df1234&r=featured%2Fcc%2F5627363&dn=aliexpress.com&durl=https%3A%2F%2Fwww.aliexpress.com%2Fssr%2F300001859%2FPNwpQFkDsR%3FdisableNav%3DYES%26pha_manifest%3Dssr%26_immersiveMode%3Dtrue&tr.idx=1&tr.co=custompage%2FcouponList%2Ffeatured",
    "from_url": "https://couponfollow.com/featured"
  }, // ... Many other coupon details
] 
```

**Field Meanings and Applications:**

- **Store Logo**: Brand image URL for visual identification in deal listings
- **Title**: Promotional headline for display in marketing materials
- **Description**: Detailed offer terms for customer understanding
- **Store URL**: Direct merchant link for affiliate tracking and user redirection
- **Store Name**: Merchant identifier for categorization and filtering
- **Discount Text**: Formatted discount value for quick comparison
- **Code**: Actual coupon code for checkout application
- **Code URL**: CouponFollow's tracking link for attribution and analytics

This structured output enables easy integration into databases, comparison engines, or automated marketing campaigns.

### How to Use the Scraper

**Step 1**: Configure your input parameters based on your data needs. Start with fewer URLs and lower item limits for testing.

**Step 2**: Set up proxy configuration with residential proxies matching your target geographic market to avoid detection.

**Step 3**: Execute the scraper and monitor for any rate limiting or blocking issues.

**Best Practices:**

- Use residential proxies from the same country as your target merchants
- Implement delays between requests to mimic natural browsing patterns
- Regularly update your URL list as CouponFollow adds new featured merchants
- Validate coupon codes periodically as they may expire

**Common Issues:**

- Rate limiting: Reduce max_items_per_url and add delays
- Blocked requests: Rotate proxy locations or use different proxy groups
- Empty results: Verify URL format and check if page structure has changed

### Benefits and Applications

This scraper provides significant time savings by automating what would otherwise require hours of manual data collection. Users can gather comprehensive coupon data from thousands of merchants in minutes rather than days.

**Real-world applications** include building competitive pricing databases, monitoring competitor promotional strategies, creating automated deal alert systems, and populating affiliate marketing platforms with fresh discount content.

The business value extends to market research, enabling companies to analyze discount trends, identify pricing opportunities, and optimize their own promotional strategies based on competitor data.

### Conclusion

The CouponFollow Coupon List Scraper transforms time-intensive manual data collection into an automated, scalable process. By accessing real-time coupon data from one of the web's largest discount platforms, users can build competitive advantages in deal aggregation, market analysis, and promotional strategy.

Ready to streamline your coupon data collection? Deploy this scraper to access CouponFollow's extensive database and transform raw discount data into actionable business intelligence.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Couponfollow Coupon List Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the coupon list in store page or featured page you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://couponfollow.com/featured",
    "https://couponfollow.com/site/amazon.ca"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://couponfollow.com/featured",
        "https://couponfollow.com/site/amazon.ca"
    ],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/couponfollow-coupon-listing-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": [
        "https://couponfollow.com/featured",
        "https://couponfollow.com/site/amazon.ca",
    ],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/couponfollow-coupon-listing-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://couponfollow.com/featured",
    "https://couponfollow.com/site/amazon.ca"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/couponfollow-coupon-listing-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/couponfollow-coupon-listing-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hYBilqfoROKjmENcp/builds/kDtfob06WRRmZuI8g/openapi.json
