tiktok-influencer-finder

TikTok Influencer Finder

Search for TikTok influencers matching a specific niche using Apify's Influencer Discovery Agent.

Quick Start

Requires requests and either GOOSEWORKS_API_KEY or APIFY_API_TOKEN env var.

# Basic search
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "fitness coaches for women over 40"

# With follower filters
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "AI and tech reviewers" \
  --min-followers 10000 --max-followers 500000

Summary table output

python3 skills/tiktok-influencer-finder/scripts/find_influencers.py
--description "vegan cooking creators" --output summary

CSV export

python3 skills/tiktok-influencer-finder/scripts/find_influencers.py
--description "sustainable fashion" --output csv

## Step 1: Gather Criteria

Before running the search, ask the user for their filtering criteria. Collect ALL of the following:

1. **Niche/Description**: What type of influencer? (use $ARGUMENTS if provided, otherwise ask)
2. **Minimum follower count**: e.g. 5K, 10K, 50K
3. **Maximum follower count**: e.g. 50K, 100K, 500K
4. **Location filter**: e.g. US only, US + Canada, any English-speaking country
5. **Sub-niche preferences**: Any specific content focus within the broader niche

Ask all 5 criteria in a single question to minimize back-and-forth. Provide sensible default options but always allow custom input.

## Step 2: Run the Search

Compose a detailed `--description` combining the user's niche, content style preferences, and target audience. Be specific and descriptive.

```bash
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "fitness coaches targeting women over 40, focus on home workouts and healthy aging" \
  --min-followers 5000 --max-followers 500000 \
  --min-fit 0.6 \
  --output json

The script uses apify~influencer-discovery-agent actor. It routes through the GooseWorks proxy when GOOSEWORKS_API_KEY is set, or directly to Apify when APIFY_API_TOKEN is set.

Step 3: Filter Results

After receiving results, apply the user's criteria:

• Remove profiles below minimum follower count
• Remove profiles above maximum follower count
• Remove profiles outside the specified location(s)
• Remove profiles that don't match the sub-niche (use the fit score and fitDescription to judge relevance; generally exclude fit < 0.6)
• Sort remaining results by fit score (descending), then by follower count (descending)

Step 4: Present Results

Present filtered results in a clean markdown table:

| Creator | Handle | Followers | Engagement | Location | Focus | Fit Score |

Include:

• Clickable TikTok profile links
• Follower count formatted readably (e.g. 46.3K)
• Engagement rate as percentage
• Brief description of their content focus
• The AI-generated fit score

After the table, include:

• Total profiles analyzed vs profiles matching criteria
• A note if very few results matched (suggest adjusting criteria)
• Offer to run another search with different keywords or adjusted criteria

CLI Reference

Flag	Default	Description
--description	required	Describe the type of influencer to find
--keywords	5	Number of search keywords to generate (max 5)
--profiles-per-keyword	10	Profiles per keyword (max 10)
--min-followers	none	Minimum follower count filter
--max-followers	none	Maximum follower count filter
--min-fit	0.0	Minimum fit score (0.0-1.0)
--output	json	Output format: json, csv, summary
--token	env var	Apify token (overrides env vars)
--timeout	300	Max seconds for Apify run

Notes

• This skill searches TikTok specifically. If the user wants other platforms, let them know this is TikTok-only and suggest alternatives.
• Engagement rates above 100% can occur when viral posts drive disproportionate interaction relative to follower count.
• The influencer discovery agent may take 1-3 minutes to complete depending on search breadth.