Douyin Music Scraper — Videos That Use a Sound (抖音音乐)

Paste any Douyin (抖音) sound or song link and get the videos that use it. This is the same list that you see when you tap the music note on a Douyin video. Every video comes with its caption, author, likes, comments, shares, saves, hashtags and a no-watermark video link. Every row also carries the sound's title, artist, album, length and total video count.

You do not need a Douyin account, a login, cookies or code. Export the results to JSON, CSV, Excel, XML or HTML, connect them to your tools with the Apify API, or ask an AI assistant such as Claude or ChatGPT to run the scraper for you.

What does the Douyin Music Scraper do?

• 🎵 Videos for any sound. It works with licensed songs and with creators' original sounds (原声).
• 🔝 Most popular first. Douyin lists the videos with the most traction first. The scraper keeps that order in the rank field.
• 📊 Engagement stats included. You get likes, comments, shares and saves for every video.
• 🎬 No-watermark video links. You get a direct link to every video without the Douyin watermark.
• 🎼 Sound details on every row. Title, artist, album, length, original-sound flag, cover and the number of videos that use the sound.
• 📈 Up to 10,000 videos per sound. You choose the number. The default is 100.
• 📋 Many sounds in one run. Paste a list of sound links or IDs.
• ✅ Clear errors. A removed sound, a video link or a link from another site gets a row that tells you what is wrong and what to do.

What data can you extract from Douyin sounds?

Data	Fields
Sound	soundId, soundUrl, soundTitle, soundAuthor (artist), soundAlbum, soundDurationSec, soundVideoCount, soundIsOriginal, soundAudioUrl, soundCoverUrl
Rank	rank — the position of the video in Douyin's list for the sound (1 = first)
Video	awemeId (video ID), url, desc (caption), createTime (publish date, UTC), durationMs, isVideo, cover, images (photo posts)
No-watermark video	videoUrlNoWatermark
Author	authorName, secUserId, authorUid, authorProfileUrl
Engagement	diggCount (likes), commentCount, shareCount, collectCount (saves)
Hashtags	hashtags
Input and errors	sourceInput (your input as you typed it), error (only on error rows)

Input

Field	Required	Description
Sound URLs or IDs (musicUrls)	Yes	One or more Douyin sound links, v.douyin.com share links of a sound, or plain sound IDs.
Max videos per sound (maxVideosPerSound)	No	The maximum number of videos for each sound. From 1 to 10,000. The default is 100.

Which links can I use?

• A sound page link: https://www.douyin.com/music/7025642736636135431
• A v.douyin.com share link of a sound from the Douyin app
• A plain sound ID: 7025642736636135431

To find the sound of a video, tap the music note at the bottom of the video in the Douyin app. On douyin.com, click the sound name under the video. Then copy that link.

Input example

{
    "musicUrls": [
        "https://www.douyin.com/music/7025642736636135431"
    ],
    "maxVideosPerSound": 100
}

Output

You get one row for each video that uses a sound. The sound's data is on every row, so you can mix many sounds in one table. Long links are shortened in this example.

Output example

{
    "sourceInput": "https://www.douyin.com/music/7025642736636135431",
    "soundId": "7025642736636135431",
    "soundUrl": "https://www.douyin.com/music/7025642736636135431",
    "soundTitle": "如果早点了解那率性的你或是晚一点遇上成熟的我",
    "soundAuthor": "小奶瓶+苏可可+圈妹+DJ YiXiu",
    "soundAlbum": "姐姐微信来了",
    "soundDurationSec": 134,
    "soundVideoCount": 34728,
    "soundIsOriginal": false,
    "soundAudioUrl": null,
    "soundCoverUrl": "https://p3-sign.douyinpic.com/tos-cn-v-2774c002/f396901402f64183b3427fae4f4a71bf~720x720.jpeg?...",
    "rank": 1,
    "awemeId": "7555748612010872121",
    "url": "https://www.douyin.com/video/7555748612010872121",
    "desc": "女子称因跛脚在入职当天被得力集团辞退",
    "createTime": "2025-09-30T05:23:37+00:00",
    "authorName": "齐鲁晚报·果然视频",
    "secUserId": "MS4wLjABAAAAJgXR2zPMW7hjnqSLr63xYAB-8ktupA2yJEO0iN_O4k8",
    "authorUid": "2711947648",
    "authorProfileUrl": "https://www.douyin.com/user/MS4wLjABAAAAJgXR2zPMW7hjnqSLr63xYAB-8ktupA2yJEO0iN_O4k8",
    "durationMs": 5922,
    "isVideo": true,
    "videoUrlNoWatermark": "https://www.douyin.com/aweme/v1/play/?video_id=v1e00fgi0000d3dmilnog65gu49ecs6g&...",
    "cover": "https://p3-pc-sign.douyinpic.com/tos-cn-p-0015c000-ce/oMhA8AIoXN8iaVVBpMazLwN7Iv1PbBmqcRCti~tplv-dy-360p.jpeg?...",
    "images": [],
    "hashtags": [],
    "diggCount": 319861,
    "commentCount": 73109,
    "shareCount": 11613,
    "collectCount": 13645
}

Error row example

When an input gives no videos, you get one row with your input and the reason. For example, a video link instead of a sound link:

{
    "sourceInput": "https://www.douyin.com/video/7667193358258867499",
    "error": "This is a Douyin video link, not a sound. In the Douyin app or on douyin.com, open the sound of the video (the music note at the bottom) and paste that link instead."
}

If Douyin stops the list in the middle of a sound, you keep the videos that you already got, and an error row tells you how many videos were saved.

How to use the Douyin Music Scraper

You can run the scraper in four ways: in Apify Console, with the Apify API, with the Apify API clients for JavaScript and Python, or from an AI assistant.

1. In Apify Console (no code)

1. Open the Actor page and click Try for free. Sign in to Apify, or create a free account.
2. In Sound URLs or IDs, paste one or more Douyin sound links or IDs. Put one item on each line.
3. Optional: change Max videos per sound. The default is 100.
4. Click Start.
5. When the run is done, open the Output tab. You see the videos in a table.
6. Click Export to download the results as JSON, CSV, Excel, XML or HTML.

To run the same input again and again, click Save as a new task. You can then add a schedule to the task, for example to check a sound every day.

2. With the Apify API (HTTP)

Get your API token in Apify Console under Settings → API & Integrations. Replace YOUR_API_TOKEN in the examples.

Run the scraper and get the results in one call. This call waits for the run to end (up to 5 minutes) and returns the videos as JSON:

curl -X POST "https://api.apify.com/v2/acts/hgservices~douyin-music-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"musicUrls": ["https://www.douyin.com/music/7025642736636135431"], "maxVideosPerSound": 100}'

For large runs, start the run and get the results later. Start the run:

curl -X POST "https://api.apify.com/v2/acts/hgservices~douyin-music-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"musicUrls": ["https://www.douyin.com/music/7025642736636135431"], "maxVideosPerSound": 1000}'

The response contains data.id (the run ID) and data.defaultDatasetId. When the run status is SUCCEEDED, get the videos. Add &format=csv or &format=xlsx to get CSV or Excel:

$curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_API_TOKEN&format=json"

To check the status, call GET https://api.apify.com/v2/actor-runs/RUN_ID?token=YOUR_API_TOKEN. You can also add a webhook that tells your server when the run is done.

3. With the JavaScript and Python API clients

JavaScript / Node.js — install the client with npm install apify-client:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('hgservices/douyin-music-scraper').call({
    musicUrls: ['https://www.douyin.com/music/7025642736636135431'],
    maxVideosPerSound: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const video of items) {
    console.log(video.rank, video.authorName, video.diggCount, video.url);
}

Python — install the client with pip install apify-client:

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("hgservices/douyin-music-scraper").call(run_input={
    "musicUrls": ["https://www.douyin.com/music/7025642736636135431"],
    "maxVideosPerSound": 100,
})

for video in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(video.get("rank"), video.get("authorName"), video.get("diggCount"), video.get("url"))

The API tab on the Actor page has more examples and the OpenAPI definition.

4. With Claude, ChatGPT and other AI assistants (MCP)

Connect your AI assistant to the Apify MCP server. The assistant can then run the Douyin Music Scraper for you and answer from the results. Use one of these server URLs:

• https://mcp.apify.com?tools=hgservices/douyin-music-scraper — gives the assistant this scraper only.
• https://mcp.apify.com — lets the assistant find and run any Actor in Apify Store.

On the first connection, you sign in to Apify in your browser.

• Claude (claude.ai and Claude Desktop): open Settings → Connectors. Click Add, then Add custom connector. Enter the name Apify and paste the server URL.
• Claude Code: run claude mcp add --transport http apify "https://mcp.apify.com?tools=hgservices/douyin-music-scraper".
• ChatGPT: turn on Developer mode. Go to Settings → Apps & Connectors → Create. Paste the server URL, select OAuth as the authentication, and click Create.
• Cursor, VS Code and other MCP clients: add the server URL as a remote (HTTP) MCP server. With the Apify CLI, you can also run apify mcp install cursor (or vscode).

Then ask in plain language. For example:

"Get the 50 most popular Douyin videos that use the sound https://www.douyin.com/music/7025642736636135431. Which creators got the most likes?"

"Compare these three Douyin sounds. For each one, show the total video count and the average likes of its top 20 videos."

Integrations

Connect the results to the tools that you already use with Apify integrations: Google Sheets, Google Drive, Slack, Make, Zapier, n8n, Airbyte, GitHub and webhooks. Use schedules to follow how a sound spreads and how its video count grows over time.

Use cases

• Music marketing — see how a song spreads on Douyin and which creators drive it.
• Trend research — find the videos behind a viral sound and what they have in common.
• Influencer discovery — find creators who already use a brand's or an artist's sound.
• Campaign tracking — follow the videos made with a campaign sound and their engagement.
• Label and artist analytics — measure the reach of a track on China's largest short-video platform.
• Competitor research — see which sounds other brands use and how well those videos do.
• Datasets for AI and research — collect videos grouped by sound, with captions and engagement stats.

Tips for the best results

• The most popular videos come first. Use a small limit to get the top videos of a sound fast.
• soundVideoCount is Douyin's own total. It is the number of videos that use the sound. It can be much larger than the number of videos that Douyin lets you list.
• Download the videos soon. The no-watermark links and image links expire. Download the files soon after the run.
• Some licensed songs have no audio link. Douyin hides the audio file of some songs for copyright reasons. You still get the videos.
• Each sound is scraped one time. If you paste the same sound two times, the second one is skipped.

FAQ

What is a Douyin sound? A sound (音乐 or 原声) is the audio track of a Douyin video. It can be a licensed song or a creator's original audio. Many videos can use the same sound.

How many videos can I get for one sound? You can get up to 10,000 videos for each sound in one run. For some sounds, Douyin ends the list earlier.

Do I need a Douyin account? No. The scraper works without a Douyin account, a password or cookies.

Can I use a video link? No. Open the sound of the video and use the sound link. The error row tells you how.

Can I scrape TikTok sounds with this Actor? No. This Actor works with Douyin (抖音), the Chinese version of TikTok, only.

Are photo posts included? Yes. For a photo post, isVideo is false and images contains the image links.

Other Douyin scrapers

• Douyin Video Downloader & Scraper — download Douyin videos without a watermark, with full video data.
• Douyin Profile Scraper — get all videos of a creator, with stats and no-watermark links.
• Douyin Search Scraper — find Douyin videos by keyword.
• Douyin Hot Search Scraper — get Douyin's trending topics and hot lists.
• Douyin Related Videos Scraper — get the videos that Douyin recommends next to a video.
• Douyin Collection Scraper — get every episode of a collection (合集) or short drama (短剧).
• Douyin Comments Scraper — get the comments and replies under Douyin videos.
• Douyin Danmaku Scraper — get the bullet comments (弹幕) of Douyin videos.
• Douyin AI Transcript Scraper — turn the speech in Douyin videos into text.

Is it legal to scrape Douyin?

This Actor collects only publicly available data. You are responsible for how you use the data. Obey Douyin's terms of service and the laws that apply to you, such as the GDPR and copyright law. Do not use the content in ways that infringe the rights of creators and rights holders.

Feedback and support

Did you find a problem, or do you need a new field? Open an issue on the Issues tab. We will reply as soon as possible.