TikTok Sound Scraper

Scrape TikTok sound metadata and videos that use a sound. The actor accepts TikTok /music/ URLs, raw clip IDs, or music search queries and exports normalized rows for analytics, creator research, trend monitoring, and AI-agent workflows.

This actor is provider-backed:

• Primary: ScrapeCreators /v1/tiktok/song and /v1/tiktok/song/videos
• Fallback: SociaVault /v1/scrape/tiktok/music/details and /v1/scrape/tiktok/music/videos
• Search: SociaVault /v1/scrape/tiktok/search/music

It does not ask users for TikTok cookies and does not scrape private or logged-in TikTok surfaces.

What It Extracts

Sound rows include:

Field	Description
clipId	TikTok sound clip ID
soundUrl	TikTok music page URL
title, author, album	Sound and artist metadata
durationSeconds, fullSongDurationMs	Clip and matched full-song duration
userCount	Number of TikTok videos using the sound when returned
coverUrl, audioUrl, shareUrl	Media links returned by the provider; some URLs can expire
isOriginal, isCommerceMusic, hasCommerceRight, canReuse	Rights and reuse flags when exposed
matchedSongTitle, matchedSongAuthor	Matched catalog song fields
themeTags, artists	Genre/mood tags and artist profile objects

Video rows include:

Field	Description
videoId, videoUrl	TikTok video identifiers
caption, hashtags, createdAt	Video content metadata
authorUsername, authorNickname, authorVerified	Creator metadata
playCount, likeCount, commentCount, shareCount, collectCount	Engagement metrics
coverUrl, durationMs, region	Video media metadata

Inputs

• soundUrls - TikTok music URLs such as https://www.tiktok.com/music/luther-7439295283975702544.
• clipIds - raw TikTok sound clip IDs.
• searchQueries - optional music search queries. Search requires SociaVault.
• outputMode - sounds_and_videos, sounds, or videos.
• providerOrder - ScrapeCreators first, SociaVault first, or a single-provider mode.
• maxSounds - total unique sounds processed.
• maxVideosPerSound - video rows to save per sound.
• maxPagesPerSound - safety cap for provider pagination.
• region, filterBy, sortType - SociaVault search controls.
• includeRawData - attach raw provider payloads to rows.

Example Input

{
  "soundUrls": [
    "https://www.tiktok.com/music/luther-7439295283975702544"
  ],
  "outputMode": "sounds_and_videos",
  "maxSounds": 1,
  "maxVideosPerSound": 25,
  "maxPagesPerSound": 5,
  "providerOrder": "scrapecreators-first",
  "includeRawData": false
}

Search Example

{
  "searchQueries": ["luther kendrick", "viral skincare sound"],
  "region": "US",
  "sortType": "1",
  "maxSearchResultsPerQuery": 5,
  "maxVideosPerSound": 20
}

Example Output

{
  "recordType": "sound",
  "provider": "scrapecreators",
  "clipId": "7439295283975702544",
  "soundUrl": "https://www.tiktok.com/music/luther-7439295283975702544",
  "title": "luther",
  "author": "Kendrick Lamar & SZA",
  "album": "GNX",
  "durationSeconds": 59,
  "userCount": 482194,
  "coverUrl": "https://p16-sg.tiktokcdn.com/aweme/720x720/example.jpeg",
  "audioUrl": "https://sf16-ies-music-sg.tiktokcdn.com/obj/example",
  "scrapedAt": "2026-06-10T00:00:00.000Z"
}

{
  "recordType": "video",
  "provider": "scrapecreators",
  "clipId": "7439295283975702544",
  "soundTitle": "luther",
  "videoId": "7452069943757114646",
  "videoUrl": "https://www.tiktok.com/@creator/video/7452069943757114646",
  "authorUsername": "creator",
  "caption": "Using this sound",
  "playCount": 2932976,
  "likeCount": 197747,
  "commentCount": 347,
  "shareCount": 26467,
  "scrapedAt": "2026-06-10T00:00:00.000Z"
}

Run Summary

Every run writes OUTPUT and RUN_SUMMARY records to the default key-value store:

{
  "recordsSaved": 26,
  "soundsSaved": 1,
  "videosSaved": 25,
  "soundsProcessed": 1,
  "providersUsed": ["scrapecreators"],
  "providerAttempts": {
    "scrapecreators.soundDetails": 1,
    "scrapecreators.soundVideos": 3
  },
  "estimatedPpeCostUsd": 0.0405,
  "stopReason": "finished"
}

Common stopReason values:

• finished - selected sounds were processed.
• invalid-input - no valid TikTok sound URL, clip ID, or query was provided.
• missing-api-key - actor owner has not configured provider API keys.
• no-sounds-discovered - search did not return usable sounds.
• provider-error - all configured providers failed before any rows were saved.
• event-limit-reached - Apify PPE charge limit stopped the run.

Pricing

This actor is designed for pay-per-event monetization:

• apify-actor-start: small start event.
• sound-scraped: one saved TikTok sound metadata row.
• video-scraped: one saved TikTok video row using the sound.

The actor logs a maximum possible PPE estimate before scraping based on maxSounds and maxVideosPerSound.

Limitations

TikTok and provider availability can change. Audio and cover URLs are provider-returned CDN URLs and may expire. Search currently uses SociaVault because the verified live ScrapeCreators docs expose sound details and videos but not a dedicated music-search endpoint. Output is public-data best effort and may differ by region, sound availability, provider coverage, or TikTok takedowns.

API Example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~tiktok-sound-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"soundUrls":["https://www.tiktok.com/music/luther-7439295283975702544"],"maxVideosPerSound":25}'

Legal

This actor is intended for public web data available through the configured providers. You are responsible for using the output in compliance with applicable laws, platform terms, privacy requirements, and your own data governance policies.