TikTok sound videos
Fetch videos that use a specific sound/music, by its numeric sound id.
GET /v1/tiktok/music/{music_id}/videos
Getting a sound id
Every post exposes the sound it uses under music.id (see the
post endpoint). Pass that value here to find other videos using
the same sound.
Path parameters
| Parameter | Type | Description |
|---|---|---|
music_id | string | Required. The numeric sound id. |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
count | integer | 30 | Videos requested per page. Maximum 35. |
max_pages | integer | 1 | Number of pages to fetch. Maximum 20. |
Example
curl -G "$LISTENX_BASE/v1/tiktok/music/7016548702018607878/videos" \
-H "X-API-Key: $LISTENX_KEY" \
--data-urlencode 'max_pages=2'
Response
{
"source": "music",
"query": "7016548702018607878",
"pages_requested": 2,
"pages_fetched": 2,
"returned": 57,
"results": [
{
"id": "7523456789012345678",
"url": "https://www.tiktok.com/@creator/video/7523456789012345678",
"type": "video",
"desc": "using this trending sound 🎵",
"author": { "unique_id": "creator" },
"engagement": { "play_count": 920000, "digg_count": 44000 },
"music": { "id": "7016548702018607878", "title": "trending sound" }
}
],
"billing": {
"endpoint": "tiktok.music_videos",
"units": 2,
"unit_price": "0.010000",
"amount": "0.020000",
"balance_after": "96.000000",
"request_id": "…"
}
}
Each item in results[] is a video record — the same shape returned by
search with type=video.
Billing
Charged per page fetched — units = pages_fetched, minimum 1. See
Billing.