TikTok Influencer Finder
Find TikTok influencers using Apify's Influencer Discovery Agent. Use when the user wants to discover TikTok creators or influencers in any niche.
by Athina AInpx gooseworks install --all # then, in Claude Code, Cursor, or Codex: /gooseworks use the tiktok-influencer-finder skill
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 csvStep 1: Gather Criteria
Before running the search, ask the user for their filtering criteria. Collect ALL of the following:
- Niche/Description: What type of influencer? (use $ARGUMENTS if provided, otherwise ask)
- Minimum follower count: e.g. 5K, 10K, 50K
- Maximum follower count: e.g. 50K, 100K, 500K
- Location filter: e.g. US only, US + Canada, any English-speaking country
- 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.
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 jsonThe 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
fitscore andfitDescriptionto 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.
What's included
fit score and fitDescription to judge relevance; generally exclude fit < 0.6)Video Production Harness
Full video production sequence with script review, actual ingredient choices, controlled generation, editing, evidence-based quality review, polish, captions and delivery. A host binding supplies project storage, authentic approvals, provider access and billing.
Render Street Interview
Build a vox-pop street interview video ad. An interviewer with a handheld mic asks passers-by one question about the brand's product, they give blunt wrong guesses, one gives the real answer, and the cut lands on a branded end card. Generates the takes through the GooseWorks fal proxy (Seedance 2.0 with native voice), then grades, re-cuts, captions and gates them locally. Use for the street-interview format.
Write Video Ad Script
Write the words of a short-form video ad (voiceover, dialogue, chat bubbles, on-screen lines) the way performance creative teams do instead of from a blank page. Builds the script from the buyers' own words, the beat sheet of an ad that already works and three deliberately different angles, filters them with a rule check and a second non-Claude model, and takes the strongest into the review with the other two as one-line swaps. Use it in every video ad run before any paid step, and whenever the user asks to write, rewrite or improve a video ad script or says a script sounds generic or AI-written.