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

Find TikTok affiliate creators and extract promo codes, sponsored posts, and engagement data. Multi-keyword search, minFollowers filter, niche filter. Supports DE, FR, ID and 9 other regions. Pay per lead.

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

## Pricing

from $2.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

## TikTok Affiliate & Influencer Video Finder

**Apify Actor for discovering TikTok affiliate creators, promo codes, and sponsored content in any 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)
[![Maintenance Status](https://img.shields.io/badge/Status-Active%20%26%20Updated-blue?style=flat-square)](https://apify.com/store)

***

### 📌 Overview & Target Use Cases

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

**TikTok Affiliate & Influencer Video Finder** automates influencer discovery by extracting structured data from TikTok videos and creator profiles — filtering for real affiliate signals: promo codes, sponsored labels, and collab posts.

#### Target Use Cases:

- **E-Commerce & DTC Brands:** Discover top affiliate creators promoting products in your specific niche.
- **Dropshippers & Product Scouts:** Spot viral winning products and the creators behind them.
- **Influencer Marketing Agencies:** Build campaign-ready lead lists with creator handles, engagement data, and promo codes.
- **Market Researchers:** Track discount strategies, creator activity, and TikTok Shop promotional patterns.

***

### ⚙️ Key Features

- **Multi-Keyword Search:** Search up to dozens of keywords in a single run — each keyword is searched independently and results are combined and deduplicated automatically.
- **Direct URL Mode:** Paste specific TikTok video URLs or creator profile URLs to bypass search and extract data from your target accounts directly.
- **Niche Filter:** Provide optional keywords like `["skincare", "retinol"]` to return only creators posting in your exact niche — automatically eliminating off-topic results.
- **Minimum Followers Filter:** Set a `minFollowers` threshold to skip micro-creators and focus only on influencers with real reach (e.g. 10,000+ followers).
- **Creator Lead Extraction:** Automatically collects creator handles (`@username`), display names, follower counts, video URLs, and engagement metrics for influencer discovery.
- **Promo Code Extraction:** Automatically finds and extracts discount codes from video captions — handles all common formats: `Use code GLOW20`, `code: SKIN10`, `Use my code to save 15% off: CT-SOC3YKKPVEU`, `DISCOUNT CODE: FIT25`. Supports hyphenated codes (Charlotte Tilbury, Huda Beauty format).
- **Sponsorship Detection:** Identifies sponsored posts (`#ad`, `#sponsored`, `paid partnership` labels, `AD/` prefix) and flags them with `is_sponsored: true`.
- **Clean Lead Consolidation:** Multiple videos from the same creator are merged into a single lead with combined promo codes and a `posts_found` counter — so you only pay for unique, actionable creator leads.

***

### 🚀 Quick Start Guide

1. **Enter Keywords:** In `Search Keywords`, add one or more search queries — one per line (e.g. `discount code skincare`, `Rabattcode Kosmetik`).
2. *(Optional)* **Direct URLs:** Paste specific TikTok video or creator profile links in `Direct TikTok Video or Creator Profile URLs`.
3. *(Optional)* **Niche Filter:** Add `nicheKeywords` to narrow results to your exact industry.
4. *(Optional)* **Min Followers:** Set `minFollowers` to filter out creators below your reach threshold.
5. **Select Country:** Choose your target country code (e.g., `US`, `GB`, `DE`). For regional accuracy, use keywords in the local language.
6. **Set Limit:** Specify `Results Limit (per keyword)` — e.g. `100` fetches 100 videos per keyword.
7. **Run & Export:** Click **Start** and export your structured leads in **JSON, CSV, Excel, or HTML**.

> **Tip:** Use a direct affiliate keyword (e.g., `discount code skincare`) for best hit rate (~40–50%). Broad niche queries like `skincare` return ~5–10% affiliate signal density — compensate by setting `resultsLimit` to 200+ per keyword.
>
> **Regional Search:** TikTok results depend on query language, not just `countryCode`. For German creators, search `Rabattcode Kosmetik` + `countryCode: DE` — not `discount code skincare`.

***

### 📥 Input Example

```json
{
  "searchKeywords": ["discount code skincare", "use code beauty"],
  "countryCode": "US",
  "nicheKeywords": ["skincare", "serum", "moisturizer"],
  "minFollowers": 5000,
  "resultsLimit": 100
}
```

***

### 📊 Sample Output Data (JSON)

```json
{
  "creator_handle": "@nehviatech.official",
  "creator_name": "Tech by Nehvia",
  "fans": 142000,
  "is_sponsored": false,
  "is_ad": false,
  "posts_found": 2,
  "promo_codes": ["RIDDHIT21", "TECH15"],
  "caption": "🎧 Upgrade Your Audio! Use code RIDDHIT21 for 20% off. Also try TECH15 for the bundle deal! #earbuds #ad",
  "likes": 14500,
  "views": 250000,
  "comments": 320,
  "shares": 1800,
  "video_duration": 42,
  "post_url": "https://www.tiktok.com/@nehviatech.official/video/7670908009501248789",
  "search_query": "wireless earbuds discount code",
  "scraped_at": "2026-08-07T18:00:00.000Z"
}
```

> **Note:** Results depend on TikTok's current content availability and the underlying scraper's data access. Login-gated or restricted content may return fewer results.

***

### 💳 Pricing Structure

This Actor uses Apify's **Pay-Per-Event (PPE)** pricing model. You only pay for the unique affiliate creator leads generated:

- **Cost:** **$2.00 per 1,000 leads** ($0.002 per lead).
- **No Monthly Minimums:** Pay only for what you scrape.
- **Free Trial:** Apify provides $5.00 free monthly compute credits to test the Actor.

***

### ❓ Frequently Asked Questions (FAQ)

**Q: Do I need a TikTok account or cookies to use this Actor?**

> **No!** The Actor uses a reliable third-party TikTok scraper under the hood and requires no login credentials, cookies, or API keys.

**Q: Can I extract leads from specific TikTok creators or videos?**

> **Yes!** Paste TikTok video URLs or profile URLs into the `Direct TikTok Video or Creator Profile URLs` field. The Actor will extract and filter affiliate signals from those specific pages.

**Q: What export formats are supported?**

> You can download your dataset from the Apify Console in **JSON, CSV, Excel (XLSX), XML, or HTML Table**.

**Q: Why does this cost $2.00 per 1,000 instead of using the base scraper directly?**

> This Actor runs a specialized keyword search engine, applies a 3-pattern promo code extraction engine (handles all caption formats including hyphenated codes like `CT-SOC3YKKPVEU`), detects sponsored content, filters by niche and follower threshold, and deduplicates creators across multiple keywords — all in a single run. You get clean, ready-to-outreach leads, not raw video data.

***

### 🔒 Support & Feedback

If you encounter any issues, have feature requests, or need custom integrations, please open an issue in the **Apify Actor Issues** tab or contact Notus AI Lab.

# Actor input Schema

## `searchKeywords` (type: `array`):

One or more search keywords. Each keyword is searched independently and results are combined. Example: \['discount code skincare', 'use code earbuds']. All keywords are searched in a single run — no need to run the actor multiple times.

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

Optional: paste specific TikTok video URLs or creator profile links (e.g. https://www.tiktok.com/@username). If provided, bypasses keyword search entirely.

## `countryCode` (type: `string`):

Target region for localized TikTok content and creators. TIP: Use a keyword in the local language for the most accurate regional results (e.g. 'mini projecteur' for FR).

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

Optional: only keep creators whose captions contain at least one of these words. Useful to narrow wide searches. Example: \['skincare', 'retinol', 'serum']. Leave empty to get all affiliate results.

## `minFollowers` (type: `integer`):

Skip creators with fewer followers than this threshold. Set to 0 to include all creators (micro-influencers included). Example: 10000 = only creators with 10K+ followers.

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

Maximum number of TikTok videos to fetch PER KEYWORD before affiliate filtering. With 3 keywords and resultsLimit=40, the actor fetches up to 120 raw videos total (40 per keyword), then filters and deduplicates them. You are only charged for the unique affiliate leads returned, not for raw videos fetched.

## Actor input object example

```json
{
  "searchKeywords": [
    "wireless earbuds discount code"
  ],
  "directUrls": [],
  "countryCode": "US",
  "nicheKeywords": [],
  "minFollowers": 0,
  "resultsLimit": 100
}
```

# Actor output Schema

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

Default dataset containing extracted TikTok affiliate videos, creator leads, and product placement 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("notus_lab/tiktok-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("notus_lab/tiktok-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 '{}' |
apify call notus_lab/tiktok-affiliate-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,notus_lab/tiktok-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/6rHhhkFUJD02scKEa/builds/bzYiQYDPbApgOHD6T/openapi.json