TikTok Sound Scraper

Scrape public TikTok videos that use one or more TikTok sounds. The Actor returns one row per video with sound metadata, video details, creator profile fields, hashtags, and engagement counts.

Use it for campaign monitoring, music trend research, creator discovery, reporting, and automated CSV/JSON/API exports.

At a glance

• Primary job: collect public TikTok videos for specific /music/ sound URLs or numeric music IDs.
• Input: TikTok sound URLs, music IDs, total result limits, per-sound limits, and optional Apify Proxy settings.
• Output: one dataset row per public video using the sound.
• Best for: brand campaign tracking, viral sound analysis, creator prospecting, and social listening workflows.

Who is it for?

Creator marketers, music marketers, social-listening teams, and trend analysts who need a repeatable export of public videos using a known TikTok sound.

TikTok music scraper workflows

• Campaign monitoring: run a branded sound daily and compare creators, captions, and engagement over time.
• Music trend research: export videos using a viral sound and sort by views, likes, comments, or shares.
• Creator discovery: collect author usernames, display names, follower counts, bios, and per-video metrics for outreach lists.
• Automation: call the Actor from the Apify API, MCP tools, webhooks, or scheduled Apify tasks and export the dataset to CSV, JSON, Excel, or BI tools.

Input recipes

Scrape TikTok sounds and export public video data

Use this TikTok sound API workflow to export a bounded, structured sample for a known public sound without downloading media or accessing private accounts.

What data can you extract?

Example input

{
  "soundUrls": [
    { "url": "https://www.tiktok.com/music/a-negroni-sbagliato-w-prosecco-l-hbo-max-7149523537730997035" }
  ],
  "maxItems": 10,
  "maxItemsPerSound": 10,
  "proxyConfiguration": { "useApifyProxy": false }
}

Example output

{
  "soundUrl": "https://www.tiktok.com/music/a-negroni-sbagliato-w-prosecco-l-hbo-max-7149523537730997035",
  "musicId": "7149523537730997035",
  "musicTitle": "a negroni sbagliato w prosecco l hbo max",
  "musicAuthor": "HBO Max",
  "musicOriginal": true,
  "musicDuration": 20,
  "videoId": "7149523510589754670",
  "videoUrl": "https://www.tiktok.com/@hbomax/video/7149523510589754670",
  "text": "I'll take one of each. #houseofthedragon",
  "createdAtISO": "2022-10-01T12:43:01.000Z",
  "hashtags": ["houseofthedragon"],
  "diggCount": 2400000,
  "playCount": 35700000,
  "shareCount": 158000,
  "commentCount": 11300,
  "authorUsername": "hbomax",
  "authorDisplayName": "HBO Max",
  "authorVerified": true,
  "scrapedAt": "2026-07-22T12:16:38.898Z"
}

Tips for best results

• Start small: Use maxItems: 10 until you confirm output quality for a sound.
• Use public sounds: Private, deleted, unavailable, or region-limited sounds may return no rows.
• Keep runs focused: Split very broad monitoring jobs into separate sounds or smaller scheduled runs.
• Enable proxy only when needed: Direct access is cheaper; Apify Proxy can help when TikTok throttles or blocks direct browser traffic.

API usage

Node.js:

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("fetch_cat/tiktok-sound-scraper").call({
  soundUrls: [{ url: "https://www.tiktok.com/music/a-negroni-sbagliato-w-prosecco-l-hbo-max-7149523537730997035" }],
  maxItems: 10,
  maxItemsPerSound: 10
});
console.log(run.defaultDatasetId);

Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("fetch_cat/tiktok-sound-scraper").call(run_input={
    "soundUrls": [{ "url": "https://www.tiktok.com/music/a-negroni-sbagliato-w-prosecco-l-hbo-max-7149523537730997035" }],
    "maxItems": 10,
    "maxItemsPerSound": 10,
})
print(run["defaultDatasetId"])

cURL:

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~tiktok-sound-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"soundUrls":[{"url":"https://www.tiktok.com/music/a-negroni-sbagliato-w-prosecco-l-hbo-max-7149523537730997035"}],"maxItems":10,"maxItemsPerSound":10}'

MCP and AI agents

Use this Actor from MCP-compatible tools through the official Apify MCP Server.

claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/tiktok-sound-scraper"

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/tiktok-sound-scraper"
    }
  }
}

Example prompt: "Run TikTok Sound Scraper for this TikTok sound URL with maxItems 10 and summarize the top videos by playCount."

Limits and caveats

• Coverage: TikTok can limit, personalize, remove, or reorder public sound results; output is a bounded public sample, not guaranteed exhaustive coverage.
• Freshness: Engagement metrics and sound availability can change after a run finishes.
• Blocking: TikTok may return challenges or throttle traffic. Retry later, reduce limits, or enable Apify Proxy if direct browser access fails.
• No private data: The Actor does not log in, bypass privacy controls, or scrape private TikTok state.

Support

Open an issue from the Actor page if a run fails or output looks wrong. Include the run ID or run URL, input JSON, expected output, actual output, and one reproducible public URL (for example, a public TikTok sound URL).