# Instagram Affiliate & Influencer Finder (+ Promo Code Scraper) (`notus_lab/instagram-affiliate-finder`) Actor

Find active affiliate creators, UGC influencers, promo codes, and sponsorship data on Instagram. Features niche keyword filtering and clean lead consolidation (pay only for unique creators).

- **URL**: https://apify.com/notus\_lab/instagram-affiliate-finder.md
- **Developed by:** [Victor Notus](https://apify.com/notus_lab) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Instagram Affiliate & Influencer Promo Code Scraper

**Apify Actor for discovering active affiliate Instagram creators, extracting UGC influencers, promo codes, sponsorship data, and filtering by niche.**

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-orange?style=flat-square\&logo=apify)](https://apify.com/store)
[![Pay Per Event](https://img.shields.io/badge/Pricing-Pay--per--Event-green?style=flat-square)](https://apify.com/store)

***

### 📌 Overview & Target Use Cases

Finding high-converting creators and viral product videos on Instagram is hard. Official APIs restrict access, and manual searching takes dozens of hours.

**Instagram Influencer & Reels Affiliate Scraper** is a specialized extraction tool that automates e-commerce product research, UGC creator discovery, and influencer outreach by extracting structured data from Instagram Reels, affiliate marketing videos, promo codes, and creator profiles.

#### Target Use Cases:

- **E-Commerce & DTC Brands:** Discover top affiliate marketing creators promoting products in your specific niche.
- **Influencer Marketing Agencies:** Build campaign-ready lead lists of Instagram creators.
- **Market Researchers:** Track promo codes, discount strategies, creator handles, and video virality analytics.

***

### ⚙️ Key Features

- **Niche Filter:** Narrow results to your exact industry. Provide keywords like `["skincare", "retinol"]` or `["fitness", "protein"]` to return only creators posting in your niche — eliminating irrelevant coupon aggregators automatically.
- **Niche & Keyword Search:** Search affiliate hashtags (e.g., `#discountcode`, `#promocode`) combined with your niche filter to surface creators who are actively promoting products in your space.
- **Creator Lead Extraction:** Automatically collects creator handles, sponsorship status (`Paid partnership` labels), and video URLs for influencer discovery.
- **Collab Post Detection:** Identifies co-authored (Collab) posts to help you find influencers doing official brand collaborations.
- **Advanced Promo Code Extraction:** Automatically finds and extracts discount codes from video captions (e.g., `Use code: NOTUS20`, `promo: GLOW20`, `discount: SKIN10`). The extraction engine handles varied caption formats, optional separators, and common false-positive patterns like `Save More` or `promotions`.
- **Clean Lead Consolidation:** Multiple posts from the same creator are merged into a single lead with combined promo codes and a `posts_found` counter — ensuring you only pay for unique, actionable creator leads.
- **Reliable Data Pipeline:** Results depend on Instagram's public hashtag accessibility — login-gated content or restricted hashtags may return fewer results.

***

### 📥 Input Example

```json
{
  "searchQueries": ["#discountcode", "#promocode"],
  "nicheKeywords": ["skincare", "beauty", "retinol"],
  "resultsLimit": 50
}
```

> **Tip:** For best results, use explicit affiliate hashtags (`#discountcode`, `#promocode`, `#couponcode`) combined with your niche keywords. Niche-only hashtags like `#skincare` yield ~15% hit rate; affiliate hashtags yield ~60% before niche filtering.
>
> **When using `nicheKeywords`:** set `resultsLimit` to **200+**. Niche content density in generic affiliate hashtags is ~3–5%, so a limit of 50 may return only 1–2 leads per run. A limit of 200 yields ~8–15 niche-targeted leads.

### 📊 Sample Output Data (JSON)

```json
{
  "creator_handle": "skincare.guru",
  "creator_name": "Anna Smith",
  "is_sponsored": true,
  "is_collab": false,
  "posts_found": 2,
  "promo_codes": ["GLOW20", "SKIN10"],
  "caption": "Get glowing skin today! #ad Use code GLOW20 for 20% off at checkout. Also try SKIN10 for the bundle!",
  "likes": 14500,
  "views": 250000,
  "comments": 320,
  "post_url": "https://www.instagram.com/reel/...",
  "scraped_at": "2026-08-07T12:00:00.000Z"
}
```

> **Note:** Follower count is not included in this Actor's output scope. This Actor focuses on affiliate signal extraction (promo codes, sponsorship labels, engagement metrics).

### 💳 Pricing Structure

This Actor uses Apify's **Pay-Per-Event (PPE)** pricing model. You only pay for the exact affiliate leads generated — **$4.00 per 1,000 results**.

# Actor input Schema

## `searchQueries` (type: `array`):

List of keywords or hashtags to search for (e.g., '#discountcode', '#promocode').

## `directUrls` (type: `array`):

List of direct Instagram Post, Reel, or Profile URLs.

## `resultsLimit` (type: `integer`):

Maximum number of reels/posts to analyze.

## `nicheKeywords` (type: `array`):

Optional. If provided, only creators whose post captions contain at least one of these keywords will be returned. Use to filter by niche (e.g., \['skincare', 'beauty', 'moisturizer'] or \['fitness', 'gym', 'protein']). Leave empty to return all affiliate leads regardless of niche.

## Actor input object example

```json
{
  "searchQueries": [
    "#discountcode",
    "#promocode"
  ],
  "directUrls": [],
  "resultsLimit": 50,
  "nicheKeywords": []
}
```

# Actor output Schema

## `dataset` (type: `string`):

Default dataset containing extracted Instagram affiliate videos, creator leads, and promo code data

# 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 = {
    "searchQueries": [
        "#discountcode",
        "#promocode"
    ],
    "directUrls": [],
    "resultsLimit": 50,
    "nicheKeywords": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("notus_lab/instagram-affiliate-finder").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 = {
    "searchQueries": [
        "#discountcode",
        "#promocode",
    ],
    "directUrls": [],
    "resultsLimit": 50,
    "nicheKeywords": [],
}

# Run the Actor and wait for it to finish
run = client.actor("notus_lab/instagram-affiliate-finder").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 '{
  "searchQueries": [
    "#discountcode",
    "#promocode"
  ],
  "directUrls": [],
  "resultsLimit": 50,
  "nicheKeywords": []
}' |
apify call notus_lab/instagram-affiliate-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,notus_lab/instagram-affiliate-finder"
        }
    }
}

```

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/m0wII9Em6eEM09DX6/builds/gfCJrQG3Qa6TydVdN/openapi.json