TikTok Music Videos

Get the videos using a sound by music URL or numeric music ID. Returns the same fields as User Videos for each video, about 12 per page.

Endpoint

GET /v1/tiktok/music/videos

Price: $0.006 per page Free tier: 50 requests/month

Parameters

Provide exactly one of url or music_id.

Parameter	Required	Description
`url`	One required	TikTok music URL, e.g. `https://www.tiktok.com/music/Face-Off-7016547803243022337` (max 500 characters).
`music_id`	One required	Numeric music ID: the number at the end of a music URL, also returned as music_id on every video.
`pages`	No	Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 12 videos.
`get_sentiment`	No	Set to `true` to add AI emotion analysis (Plutchik’s Wheel) to each result. Adds +$0.001 per page to the cost. Returns emotion scores, dominant emotion, intensity, and polarity.

Response Fields

Field	Type	Description
`videos`	array	Array of videos using the sound
`videos[].video_id`	string	Numeric video ID
`videos[].title`	string	Video caption
`videos[].url`	string	Direct link to the video
`videos[].date`	string	Publication date and time
`videos[].date_timestamp`	integer/null	Publication date as a Unix timestamp
`videos[].author`	string	Author’s TikTok username
`videos[].source`	string	`"TikTok"`
`videos[].domain`	string	`"tiktok.com"`
`videos[].snippet`	string	Video caption text
`videos[].region`	string	2-letter region code the video was posted from
`videos[].play_count`	integer	Number of plays/views
`videos[].likes`	integer	Number of likes
`videos[].comments`	integer	Number of comments
`videos[].shares`	integer	Number of shares
`videos[].downloads`	integer	Number of downloads
`videos[].saves`	integer	Number of saves (favorites)
`videos[].duration`	integer	Video duration in seconds (0 for photo posts)
`videos[].is_ad`	boolean	Whether the video is an ad
`videos[].is_pinned`	boolean	Whether the video is pinned to the author’s profile
`videos[].author_name`	string	Author’s display name
`videos[].author_id`	string	Author’s numeric user ID
`videos[].author_avatar`	string	Author’s avatar URL
`videos[].author_url`	string	Link to the author’s profile
`videos[].cover`	string	Video cover/thumbnail URL
`videos[].dynamic_cover`	string	Animated cover URL
`videos[].origin_cover`	string	Original cover frame URL
`videos[].video_url`	string	Watermark-free playback/download URL (temporary)
`videos[].video_url_watermarked`	string	Watermarked playback URL (temporary)
`videos[].size`	integer	File size of the watermark-free video in bytes
`videos[].size_watermarked`	integer	File size of the watermarked video in bytes
`videos[].images`	string[]	Image URLs for photo posts; empty for videos
`videos[].music_id`	string	ID of the sound used
`videos[].music_url`	string	Playback URL of the sound
`videos[].mentioned_user_ids`	string[]	Numeric IDs of the users mentioned in the caption
`videos[].sentiment`	object/null	Emotion analysis results. Only present when `get_sentiment=true`. Returns `null` if analysis fails.
`videos[].sentiment.emotions`	object	Plutchik emotion scores (0-100) for: `joy`, `trust`, `fear`, `surprise`, `sadness`, `disgust`, `anger`, `anticipation`.
`videos[].sentiment.dominant_emotion`	string	The emotion with the highest score.
`videos[].sentiment.emotional_intensity`	integer	Overall emotional intensity on a scale of 0-10.
`videos[].sentiment.polarity`	string	Overall sentiment polarity: `positive`, `negative`, or `neutral`.
`music_id`	string	The sound’s numeric ID
`pages`	integer	Number of pages returned
`count`	integer	Number of results returned

Example Request

cURL

curl "https://apidirect.io/v1/tiktok/music/videos?music_id=7016547803243022337&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/music/videos",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "music_id": "7016547803243022337",
        "pages": 2
    }
)
print(response.json())

Example Response

{
  "videos": [
    {
      "video_id": "7039385772222319878",
      "title": "it's about drive #thebadp1ace",
      "url": "https://www.tiktok.com/@thebadp1ace/video/7039385772222319878",
      "date": "2021-12-08 17:32:01",
      "date_timestamp": 1638984721,
      "author": "thebadp1ace",
      "source": "TikTok",
      "domain": "tiktok.com",
      "snippet": "it's about drive #thebadp1ace",
      "region": "US",
      "play_count": 77202977,
      "likes": 16419428,
      "comments": 60056,
      "shares": 172134,
      "downloads": 101612,
      "saves": 733192,
      "duration": 14,
      "is_ad": false,
      "is_pinned": false,
      "author_name": "ale",
      "author_id": "6911054760808875014",
      "author_avatar": "https://p16-common-sign.tiktokcdn-eu.com/.../avatar.jpeg",
      "author_url": "https://www.tiktok.com/@thebadp1ace",
      "cover": "https://p16-common-sign.tiktokcdn-eu.com/.../cover.jpeg",
      "dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../dynamic_cover.webp",
      "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../origin_cover.jpeg",
      "video_url": "https://v19.tiktokcdn-eu.com/.../video.mp4",
      "video_url_watermarked": "https://v19.tiktokcdn-eu.com/.../video_wm.mp4",
      "size": 10246341,
      "size_watermarked": 9402354,
      "images": [],
      "music_id": "7016547803243022337",
      "music_url": "https://sf16-music.tiktokcdn-eu.com/.../music.mp3",
      "mentioned_user_ids": []
    }
  ],
  "music_id": "7016547803243022337",
  "pages": 2,
  "count": 24
}