toolzerhub API Docs

List TikTok videos by sound

Returns public videos that use a sound, given its music_id (the music.id on any returned video). Page with cursor and count. An unknown sound returns data: null.

1 credit / requestBilled only on success
GET
/v1/tiktok/music_videos

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

music_id*string

TikTok's own numeric id for the sound. Every video this surface and /tiktok/video return carries one, so nothing has to be resolved first.

cursor?|

Where to resume. 0 for the first page, then the next_cursor a previous response returned, verbatim. It is TikTok's own token, not a page number.

Range0 <= value
Default0
count?integer

How many videos to ask for. A ceiling, not a page size — 6, 12, 25, 27 and 30 items were all returned for count=30 across seven sounds.

Range1 <= value <= 50
Default30
curl -X GET "https://example.com/v1/tiktok/music_videos?music_id=6704931455228725250" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "entries": [      {        "id": "7497430262331182382",        "desc": "string",        "create_time": 0,        "author": {          "id": "string",          "unique_id": "tiktok",          "nickname": "string",          "sec_uid": "string",          "verified": true        },        "stats": {          "play_count": 578100,          "digg_count": 98800,          "comment_count": 0,          "share_count": 0        },        "stats_v2": {          "property1": null,          "property2": null        },        "hashtags": [          "string"        ],        "video": {          "cover": "string",          "duration": 0,          "ratio": "540p"        },        "music": {          "id": "6704931455228725250",          "title": "I Want to Be Your Man",          "author_name": "Roger"        }      }    ],    "count": 0,    "next_cursor": "string",    "has_more": true  }}