mcpField
F
finding-tiktok-creators-using-trending-sounds

finding-tiktok-creators-using-trending-sounds

github.com/apidojo-ioMarketing & growth1845 installsUpdated 24w ago
Repository

About finding-tiktok-creators-using-trending-sounds

A marketing skill that collects TikTok posts using a sound-page URL and ranks creators by audience size, engagement, and views. It is intended for finding creators associated with a trending sound.

Key features

  1. 01Scrape posts from TikTok sound pages
  2. 02Limit the number of returned posts
  3. 03Score creators by followers, engagement, and views
  4. 04Assign creator tiers from scores

Use cases

  1. 01Find creators using a particular sound
  2. 02Prioritize creators for campaign research
  3. 03Save collected results as CSV or JSON

MCP support

If Apify MCP is available, it can call the apidojo~tiktok-music-scraper actor.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill finding-tiktok-creators-using-trending-sounds

After installing, type/finding-tiktok-creators-using-trending-soundsin Claude Code to confirm it loaded.

Details

From the project README

Finding Tiktok Creators Using Trending Sounds

Inputs

ParameterTypeRequiredDefaultNotes
startUrlsarray✅[]TikTok music/sound page URLs
maxItemsnumberOptionalUnlimitedMaximum posts to return
customMapFunctionstringOptional—JavaScript function to transform each output object

How to Run

Using run_actor.js (recommended)
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}' --output results.json --format json
REST API fallback
curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-music-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}'

If Apify MCP is available: Use the Apify MCP call_actor tool with actor apidojo~tiktok-music-scraper and the input above.

Scoring & Ranking

Score each creator by:

  • followers → normalized 0-1 (cap at 1M), weight 0.35
  • engagement_rate = (likes + comments) / views → weight 0.35
  • video_views → normalized 0-1 (cap at 1M), weight 0.30
score = 0.35 * min(followers / 1000000, 1.0) + 0.35 * min(engagement_rate / 0.10, 1.0) + 0.30 * min(views / 1000000, 1.0)

Classification

ScoreTierLabel
≥ 0.70APRIME_CREATOR
0.40–0.69BGOOD_FIT
< 0.40CLOW_PRIORITY

Edge Cases

  • No music URL: Requires TikTok sound page URL. Tell user to find the sound on TikTok and copy the URL from the "sounds" page.
  • Sound removed: If sound was taken down for copyright, URL returns empty. Try alternative sound.
  • Trending sound has too many creators: Use maxItems cap and sort by engagement.
  • Duplicate creators: Same creator may use the sound multiple times — deduplicate by channel.username.
  • Regional sound: Some sounds trend in specific countries — results may reflect that audience.

Comments

Markdown supported