finding-tiktok-ugc-creators-for-brands — Claude Code skill
Discovers TikTok UGC creators through Apify scrapers and ranks them by engagement. Designed for brands building influencer outreach rosters.
npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a claude-codeWhat finding-tiktok-ugc-creators-for-brands does
The skill automates creator discovery for brand campaigns. It triggers apidojo~tiktok-scraper across product review hashtags to collect candidate accounts. Then apidojo~tiktok-profile-scraper retrieves profile metrics, recent posts, and interaction counts.
Each profile receives a score calculated from engagement rates, view-to-follower ratios, and niche relevance. Filters discard official company profiles, flag isolated viral spikes, and drop accounts inactive for over 60 days. The final roster formats candidates into tiered tables.
Without the APIFY_TOKEN environment variable, the scrapers cannot run. The workflow supports the Apify MCP server, the run_actor.js helper script, and direct REST calls.
What it helps with
- find TikTok UGC creators for specific product niches
- filter out company brand profiles from hashtag results
- score creators using engagement and view-to-follower metrics
- flag viral anomalies inflating average view counts
Example prompts for the agent
- Find TikTok creators making honest reviews in the skincare niche
- Build a roster of micro-creators for a paid UGC fitness campaign
- Discover tech unboxing creators on TikTok and rank them by engagement
How to install finding-tiktok-ugc-creators-for-brands
1Skills CLI (Vercel)
npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a claude-code2Manually: put the files in place
~/.claude/skills/finding-tiktok-ugc-creators-for-brands/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/finding-tiktok-ugc-creators-for-brands/
1Skills CLI (Vercel)
npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a codex2Manually: put the files in place
.agents/skills/finding-tiktok-ugc-creators-for-brands/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a cursor2Manually: put the files in place
.cursor/skills/finding-tiktok-ugc-creators-for-brands/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install apidojo-io/apidojo-skills finding-tiktok-ugc-creators-for-brands2Manually: put the files in place
.github/skills/finding-tiktok-ugc-creators-for-brands/SKILL.md1Skills CLI (Vercel)
npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a gemini-cli2Platform CLI
gemini skills install https://github.com/apidojo-io/apidojo-skills --path skills/intent/finding-tiktok-ugc-creators-for-brandsManually: put the files in place
.devin/skills/finding-tiktok-ugc-creators-for-brands/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about finding-tiktok-ugc-creators-for-brands
How to install finding-tiktok-ugc-creators-for-brands in Claude Code?
Run npx skills add apidojo-io/apidojo-skills --skill finding-tiktok-ugc-creators-for-brands -a claude-code. This puts the skill at ~/.claude/skills/finding-tiktok-ugc-creators-for-brands/SKILL.md.
What does finding-tiktok-ugc-creators-for-brands do?
It searches TikTok posts via Apify actors, extracts creator engagement metrics, and compiles structured rosters for brand marketing initiatives.
What are the prerequisites for this skill?
You must set the APIFY_TOKEN environment variable in your shell or .env file. Workflows can run through an Apify MCP server, the run_actor.js script, or Apify REST endpoints.
Source text
SKILL.md · Apache-2.0
---
name: finding-tiktok-ugc-creators-for-brands
description: >
Finds TikTok UGC creators for brand campaigns using apidojo's TikTok scrapers on Apify.
Triggers when the user asks to: find TikTok creators for user-generated content, discover UGC
creators in a product category on TikTok, find micro-creators who post organic product reviews
on TikTok, identify TikTok creators for paid UGC campaigns, find authentic content creators
in beauty food tech or fitness on TikTok, or build a UGC creator roster for a brand.
Returns creator handle, follower count, avg views, engagement rate, niche, and content samples.
Ideal for e-commerce brands, DTC companies, and influencer marketing managers.
license: Apache-2.0
metadata:
author: apidojo
version: "1.0"
apify-actors: apidojo/tiktok-scraper, apidojo/tiktok-profile-scraper
---
# Finding TikTok UGC Creators for Brands
Discovers TikTok micro-creators who produce authentic product content. UGC creators (1K–100K followers) deliver the highest ROI for paid campaigns — authentic feel, affordable rates, and high engagement relative to follower count.
## Prerequisites
- `APIFY_TOKEN` environment variable set
- Optional: Apify MCP server installed
## Inputs
| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| `startUrls` | array | Optional | `[]` | TikTok URLs — user profiles, hashtags, music pages, search, locations |
| `keywords` | array | Optional | `[]` | Search keywords/terms to find posts |
| `sortType` | string | Optional | `RELEVANCE` | Sort order for keyword results: `RELEVANCE`, `MOST_LIKED`, `DATE_POSTED` |
| `location` | string | Optional | — | ISO 3166-1 alpha-2 country code for regional filtering (e.g. `US`, `GB`) |
| `maxItems` | number | Optional | Unlimited | Maximum posts to return across the run |
| `includeSearchKeywords` | boolean | Optional | `false` | Add the matched search keyword field to each post |
| `customMapFunction` | string | Optional | — | JavaScript function to transform each output object |
## Workflow
```
Progress:
- [ ] Step 1: Search hashtags for niche UGC content
- [ ] Step 2: Collect creator handles from search
- [ ] Step 3: Enrich profiles
- [ ] Step 4: Score UGC fit
- [ ] Step 5: Deliver creator roster
```
### Step 1: Build Hashtag Searches
```
Hashtags for niche: #[niche]review, #[niche]haul, #[niche]unboxing, #[niche]honest review,
#[niche]foryou, #ugc[niche], #[niche]tiktokmademebuyit
```
Example for skincare:
```
["#skincarereviews", "#skincarehaul", "#skincaretiktok", "#ugcskincare", "#honestskincarereview"]
```
**Recommended — run_actor.js (handles waiting, output, and file saving automatically):**
```bash
# Quick answer (prints table to chat)
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}'
# Save as CSV
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}' \
--output YYYY-MM-DD_results.csv --format csv
# Save as JSON
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}' \
--output YYYY-MM-DD_results.json --format json
```
> `APIFY_TOKEN` must be set in environment or `.env` file.
**If Apify MCP is available:**
```
Tool: apify:run-actor
Actor: "apidojo~tiktok-scraper"
Input:
{
"keywords": ["#[niche]review", "#[niche]haul", "#ugc[niche]"],
"maxItems": 200
}
```
**REST API fallback:**
```bash
curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-scraper/runs?token=$APIFY_TOKEN" -H "Content-Type: application/json" -d '{
"keywords": ["#skincarereviews", "#skincarehaul"],
"maxItems": 200
}'
```
Collect unique `authorMeta.name` (handles) with > 2 posts in niche.
### Step 2: Enrich Creator Profiles
**If Apify MCP is available:**
```
Tool: apify:run-actor
Actor: "apidojo~tiktok-profile-scraper"
Input:
{
"profiles": ["https://www.tiktok.com/@[handle1]", "https://www.tiktok.com/@[handle2]"]
}
```
**REST API fallback:**
```bash
curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-profile-scraper/runs?token=$APIFY_TOKEN" -H "Content-Type: application/json" -d '{"profiles": ["https://www.tiktok.com/@handle1"]}'
```
### Step 3: Score UGC Fit
```
engagement_rate = (avg_likes + avg_comments) / follower_count * 100
view_to_follower_ratio = avg_views / follower_count
ugc_score = (engagement_rate > 5 ? 1 : engagement_rate / 5) * 0.35
+ (view_to_follower_ratio > 1 ? 1 : view_to_follower_ratio) * 0.30
+ (follower_count in 5000..50000 ? 1 : 0.6) * 0.20
+ (posts_in_niche >= 3 ? 1 : posts_in_niche / 3) * 0.15
```
**UGC tier classification:**
- **TIER 1** (score ≥ 0.75): High engagement, consistent niche content — ideal for paid UGC
- **TIER 2** (score 0.50–0.74): Good engagement, some niche overlap — worth testing
- **TIER 3** (score < 0.50): Low engagement or single niche post — aspirational / monitoring list
### Step 4: Edge Cases
- **Brand accounts appear in hashtag results**: Drop entries where bio contains "Official", "brand", "@company" — keep only individual creators
- **Views from single viral video inflating avg**: Calculate avg from last 10 posts; flag if std_dev > 3× avg (viral outlier)
- **Creator posts in multiple niches**: Track `niche_concentration = niche_posts / total_posts`; flag if < 30%
- **Inactive creators**: Skip if `lastPostDate > 60 days ago`
## Output Format
```
# TikTok UGC Creator Roster: [NICHE]
Creators evaluated: [N] | TIER 1: [N] | TIER 2: [N] | Date: [DATE]
## TIER 1 — Prime UGC Creators
| Creator | Handle | Followers | Avg Views | Eng Rate | View/Follower | Niche % | Score |
|---------|--------|-----------|-----------|----------|---------------|---------|-------|
| [name] | @[handle] | [N] | [N] | [X%] | [X.X×] | [X%] | [0.XX] |
## TIER 2 — Worth Testing
| Creator | Followers | Avg Views | Eng Rate | Last Active |
|---------|-----------|-----------|----------|------------|
## Niche Hashtag Performance
| Hashtag | Posts Scraped | Avg Views per Post | Top Creator Found |
|---------|--------------|-------------------|-------------------|
```
## Troubleshooting
**Too many brand accounts**: Tighten filter — drop accounts with `follower_count > 500K` and accounts with verification badge.
**Hashtag returns mainly brand posts**: Switch to user-driven hashtags: `#tiktokmademebuyit[niche]`, `#[niche]recommendation`.
**Creators found aren't making product content**: Use hashtags that explicitly signal product review intent rather than broad niche tags.
© apidojo · Apache-2.0 · apidojo-io/apidojo-skills