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

Ready-to-run examples

• Brand campaign sound monitor

• Music trend research sample

• Creator discovery by sound ID

• Small smoke test: use the default TikTok sound URL with maxItems: 10.

• Brand campaign sound monitor: provide one branded /music/ URL with maxItems: 500 and schedule recurring runs.

• Creator discovery by sound ID: provide musicIds: ["7149523537730997035"] with maxItemsPerSound: 250.

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?

Field	Description
soundUrl	TikTok sound URL processed for the row.
musicId	Numeric TikTok music/sound ID.
musicTitle	Public sound title.
musicAuthor	Sound author or owner name.
musicOriginal	Whether TikTok marks the sound as original.
musicDuration	Sound duration in seconds when available.
musicCoverUrl	Public sound cover image URL.
musicPlayUrl	Public audio playback URL when exposed by TikTok.
videoId	TikTok video ID.
videoUrl	Public video URL.
text	Video caption text.
createdAt, createdAtISO, locationCreated	Video creation timestamp and public location when supplied.
isAd, isMuted	Public video status flags when supplied.
duration, width, height, coverUrl	Public video duration, dimensions, and cover URL.
hashtags	Caption hashtags.
diggCount, playCount, shareCount, commentCount, collectCount	Public engagement metrics.
authorId, authorUsername, authorDisplayName, authorVerified	Creator identity fields.
authorAvatar, authorBio, authorPrivate	Public creator profile details and status.
authorFollowerCount, authorFollowingCount, authorLikeCount	Public creator statistics.
scrapedAt	Actor collection timestamp.

Input configuration

Setting	JSON key	Use it for	Example
TikTok sound URLs	soundUrls	Full public TikTok /music/ URLs.	[{"url":"https://www.tiktok.com/music/a-negroni-sbagliato-w-prosecco-l-hbo-max-7149523537730997035"}]
Music IDs	musicIds	Numeric sound IDs when you do not have a full URL.	["7149523537730997035"]
Maximum video rows	maxItems	Cap total saved rows and control spend.	100
Maximum rows per sound	maxItemsPerSound	Prevent one sound from consuming the whole run.	50
Proxy configuration	proxyConfiguration	Enable Apify Proxy if TikTok blocks direct access.	{ "useApifyProxy": true }

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"
}

Pricing

The Actor charges for each public video row successfully saved to the dataset. Current tier rates are shown on the TikTok Sound Scraper Pricing tab.

Keep limits low while testing. The Actor validates inputs before browser, proxy, or charge work and only charges for rows pushed to the dataset.

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.

Related actors

More TikTok scrapers

• TikTok Profile Scraper
• TikTok Ads Library Scraper
• TikTok Followers and Following Scraper
• TikTok User Search Scraper
• TikTok Video Scraper

FAQ

What data can I export with TikTok Sound Scraper?

You can export public sound, video, creator, hashtag, and engagement fields as dataset rows in JSON, CSV, Excel, XML, RSS, or through the API.

Can I run TikTok Sound Scraper through an API, schedule, or MCP client?

Yes. Use the API examples above, schedule a bounded run in Apify, or call the Actor through an MCP-compatible client.

How much does TikTok Sound Scraper cost?

You are charged only when the Actor saves a public video row. Current tier rates are listed in the Pricing section and on the Actor Pricing tab.

Why are some fields empty?

TikTok does not expose every field for every public video or sound. The Actor leaves unavailable fields empty instead of guessing.

Can I scrape by music ID only?

Yes. Add numeric IDs to musicIds; the Actor builds a TikTok sound URL and captures the public response for that ID.

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).