# TikTok Sound Videos API (`deepmine/tiktok-sound-videos`) Actor Get the videos that use a TikTok sound (song or original audio), plus the sound's title, artist and how many videos use it. Each video comes with plays, likes, comments, shares, caption and creator. Sound IDs or music URLs in. No login. - **URL**: https://apify.com/deepmine/tiktok-sound-videos.md - **Developed by:** [DeepMine](https://apify.com/deepmine) (community) - **Categories:** Social media, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 videos This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## TikTok Sound Videos API Get the **videos that use a TikTok sound** (a song or an original audio) as clean rows, plus the **sound's details**: title, artist, the account that published it and how many videos use it. Every video comes with plays, likes, comments, shares, saves, caption, hashtags, the creator and their follower count, cover, post date and its place in the sound's feed. Paste sound IDs or TikTok music URLs. No TikTok account, no cookies, no login. | Creator | Caption | ▢️ Plays | ❀️ Likes | πŸ“… Posted | 🎡 Sound | πŸ… Rank | |---|---|---:|---:|---|---|---:| | [@kyliejordan998](https://www.tiktok.com/@kyliejordan998/video/7248719171754675498) | Excuse my husbands foul mouth 🀣 will never get rid… | 35,600,000 | 4,100,000 | 2023-06-25 | Back In Black | 1 | | [@natalia\_veretelnik](https://www.tiktok.com/@natalia_veretelnik/video/7067106494281469185) | Иногда Ρ‚Π°Ρ€Π° катится, ΠΈ случаСтся казус! #Ρ„ΡŒΡŽΠ·ΠΈΠ½Π³ #… | 79,300,000 | 2,800,000 | 2022-02-21 | Back In Black | 2 | | [@mrbinoobeans](https://www.tiktok.com/@mrbinoobeans/video/7063517123154382086) | but just one more kiss πŸ₯Ί #fyp #kittens | 72,700,000 | 17,500,000 | 2022-02-11 | Little Things | 1 | Collected 2026-09-27 with `{"sounds": ["https://www.tiktok.com/music/Back-In-Black-6715195986316101634", "7089644688840099841"], "maxVideosPerSound": 15}`. Every video row also has comments, shares, saves, the creator's name, follower count and verified badge, duration, hashtags, mentions and cover; each sound gets one row of its own in the 🎡 Sounds dataset. **$0.80 per 1,000 videos** on the Starter plan ($1.00 Free, $0.60 Scale, $0.50 Business); the sound rows are free. The prefilled run (100 videos) costs about $0.08. ### Why this one - **Sound stats included.** A separate **🎡 Sounds** dataset holds each sound's title, artist, length, audio link and total video count (Back In Black: 3,900,000 videos on 2026-09-27), so you can track how far a sound has spread. - **Creator size on every video.** The creator's follower count comes with each row: find the creators who used a song and sort them by reach. - **Deep pages.** Popular sounds page deep: 350+ videos in our tests, up to 5,000 per sound per run. - **Fails loudly, never silently.** Every run saves a per-sound summary (`OUTPUT`) with its status and why it stopped. If TikTok refuses a sound on every retry, the run is marked failed instead of quietly returning less. - **Fast and light.** Plain HTTP, no browser. ### Input | Field | What it does | Default | |---|---|---| | `sounds` | Sound IDs or TikTok music URLs, e.g. `7675014190469335838` or `https://www.tiktok.com/music/original-sound-7675014190469335838`. Tip: on a video, tap the sound to open its page and copy the URL. | `https://www.tiktok.com/music/Back-In-Black-6715195986316101634` | | `maxVideosPerSound` | Videos per sound, up to 5,000. | 100 | | `proxyConfiguration` | Apify Proxy. Datacenter (the default) works; switch to residential only if a run reports blocks. | Apify datacenter | Example: ```json { "sounds": ["https://www.tiktok.com/music/original-sound-7675014190469335838"], "maxVideosPerSound": 500 } ``` ### Output Two datasets, sound by sound in your order: - **🎬 Videos** (the default dataset): one row per video, each sound's videos in TikTok's order (`rank` 1, 2, 3...). Views: **πŸ“Š Overview** (πŸ–ΌοΈ Cover, 🏷️ Username, πŸ‘€ Creator, πŸ“ Caption, πŸ”— TikTok, ▢️ Plays, ❀️ Likes, πŸ’¬ Comments, πŸ” Shares, πŸ‘₯ Followers, πŸ“… Posted, 🎡 Sound, πŸ… Rank) and **πŸ“ˆ Stats** (🏷️ Username, πŸ”— TikTok, ▢️ Plays, ❀️ Likes, πŸ’¬ Comments, πŸ” Shares, πŸ”– Saves, πŸ‘₯ Followers, ⏱️ Duration, πŸ“… Posted, 🎡 Sound, πŸ… Rank). - **🎡 Sounds**: one row per sound. View **πŸ“Š Overview**: πŸ–ΌοΈ Cover, 🎡 Sound, 🎀 Artist, πŸ”— TikTok, 🎬 Videos, ⏱️ Duration, πŸŽ™οΈ Original, 🎧 Audio. A value TikTok didn't send is `null` (never an empty string or a made-up 0). #### Video fields - `cover`: the video's cover image. - `authorName`: the creator's display name. - `caption`: the full caption, hashtags included. - `captionSnippet`: the caption's first 50 characters on one line, for tables. - `authorUsername`: the creator's TikTok username, without @. - `videoUrl`: the video's page on TikTok. - `authorVerified`: the creator has TikTok's verified badge. - `plays`: views. - `likes`: likes. - `comments`: comments. - `shares`: shares. - `saves`: saves (TikTok's Favorites). - `authorFollowers`: the creator's followers when the video was collected. - `durationSeconds`: length of the video in seconds (`null` for photo posts). - `postedAt`: when it was posted (UTC). - `rank`: the video's place in the sound's feed as collected, 1 = first. - `hashtags`: hashtags in the caption, without #. - `mentions`: usernames mentioned in the caption. - `soundTitle`: the sound you asked for. - `soundUrl`: the sound you asked for, on TikTok. - `photos`: the images of a photo post (a slideshow set to the sound); `null` for videos. - `videoId`: TikTok's video ID. - `scrapedAt`: when it was collected (UTC). #### Sound fields - `cover`: the sound's cover art. - `soundTitle`: the sound's title. - `soundAuthor`: the sound's artist or creator name. - `soundUrl`: the sound's page on TikTok. - `videos`: videos using the sound, as TikTok counts them. - `durationSeconds`: length of the sound in seconds. - `isOriginal`: a creator's own audio, not a released track. - `audioUrl`: the sound's audio file. - `creatorUsername`: the TikTok user who made an original sound (`null` for licensed music). - `soundId`: TikTok's sound (music) ID. - `scrapedAt`: when it was collected (UTC). Example video row: ```json { "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-...", "authorName": "Kylie Jordan πŸ’œ", "caption": "Excuse my husbands foul mouth 🀣 will never get rid of wasp nest another way again! #tiktokhacks #gasolina #wasp #fyp", "captionSnippet": "Excuse my husbands foul mouth 🀣 will never get rid…", "authorUsername": "kyliejordan998", "videoUrl": "https://www.tiktok.com/@kyliejordan998/video/7248719171754675498", "authorVerified": false, "plays": 35600000, "likes": 4100000, "comments": 23200, "shares": 1200000, "saves": 405136, "authorFollowers": 25500, "durationSeconds": 54, "postedAt": "2023-06-25T20:12:45Z", "rank": 1, "hashtags": ["tiktokhacks", "gasolina", "wasp", "fyp"], "mentions": null, "soundTitle": "Back In Black", "soundUrl": "https://www.tiktok.com/music/back-in-black-6715195986316101634", "photos": null, "videoId": "7248719171754675498", "scrapedAt": "2026-09-27T19:07:55Z" } ``` Example sound row: ```json { "cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/9fdc3a8...", "soundTitle": "Back In Black", "soundAuthor": "AC/DC", "soundUrl": "https://www.tiktok.com/music/back-in-black-6715195986316101634", "videos": 3900000, "durationSeconds": 60, "isOriginal": false, "audioUrl": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/fc9a30f3...", "creatorUsername": null, "soundId": "6715195986316101634", "scrapedAt": "2026-09-27T19:07:55Z" } ``` Notes: - Videos come in TikTok's own order for the sound page (not newest first). - TikTok rounds large counters on its web pages (67.3M plays shows as `67300000`); small numbers are exact. Now and then TikTok sends a video's plays, likes, shares and saves as 0 next to real comments; those come as `null`. - **Image links expire.** `cover` and `photos` are signed by TikTok and stop working about 2 days after the run; `audioUrl` can expire too. Download what you need soon after the run. #### Run summary (`OUTPUT`) ```json { "results": 227, "inputs": [ {"input": "https://www.tiktok.com/music/original-sound-7675014190469335838", "status": "ok", "results": 200, "stopReason": "max_results", "soundVideos": 693000}, {"input": "1234567890123", "status": "not_found", "results": 0, "stopReason": "not_found"} ] } ``` `status` per sound: `ok`, `not_found`, `invalid`, `blocked` (TikTok refused it on every retry; the run fails so you notice), `stopped` (your spending limit). `stopReason`: `max_results`, or `end` when TikTok showed no more videos. Smaller sounds can show fewer videos than their count: TikTok lists only part of them to logged-out visitors (in our test, a sound used by 143 videos showed 27). ### Pricing Pay per result, no start fee and no minimum. Example: 1,000 videos cost $0.80 on the Starter plan. | Your Apify plan | Per 1,000 videos | |---|---| | Free | $1.00 | | Starter | $0.80 | | Scale | $0.60 | | Business | $0.50 | You pay only for video rows that reach your dataset; the sound rows are free. Unknown sounds and invalid inputs cost nothing. When your spending limit is reached, the run stops. ### FAQ **Do I need a TikTok account?** No. The Actor reads only what TikTok shows logged-out visitors. **Where do I find a sound's ID?** It's the number at the end of the sound's page URL: `tiktok.com/music/-`. Rows from our other TikTok APIs link each video's sound in `soundUrl`, which you can paste here as is. ### Feedback Missing a field, or a result that doesn't look right? Open an issue on the **Issues** tab and we'll look into it. If the data helps you, a short review on this page helps other people find it. # Actor input Schema ## `sounds` (type: `array`): Sound IDs or TikTok music URLs, one per line. Example: https://www.tiktok.com/music/original-sound-7675014190469335838 ## `maxVideosPerSound` (type: `integer`): Videos to get per sound, in TikTok's own order for the sound page. You pay per video; the sound's own row is free. ## `proxyConfiguration` (type: `object`): TikTok is reached through Apify Proxy. Datacenter proxies (the default) work for these pages; switch to residential only if your runs report blocks. ## Actor input object example ```json { "sounds": [ "https://www.tiktok.com/music/Back-In-Black-6715195986316101634" ], "maxVideosPerSound": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): No description ## `sounds` (type: `string`): No description ## `summary` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sounds": [ "https://www.tiktok.com/music/Back-In-Black-6715195986316101634" ], "maxVideosPerSound": 100, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("deepmine/tiktok-sound-videos").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sounds": ["https://www.tiktok.com/music/Back-In-Black-6715195986316101634"], "maxVideosPerSound": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("deepmine/tiktok-sound-videos").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sounds": [ "https://www.tiktok.com/music/Back-In-Black-6715195986316101634" ], "maxVideosPerSound": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call deepmine/tiktok-sound-videos --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/tiktok-sound-videos" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/DsT38CF9FLQcwTQ06/builds/924ZsgcIR153rC8AC/openapi.json