← API Store
Social
TikTok
TikTok
Videos using a TikTok sound
GET /tiktok/v1/song/videosEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Example: 7016547803243022337 |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 30,
"credits_used": 1,
"next_cursor": "30",
"song_id": "7016547803243022337",
"videos": [
{
"ai_generated": null,
"author": {
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_toke…",
"id": "6745191554350760966",
"nickname": "The Rock",
"username": "therock",
"verified": true
},
"author_info": {
"avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=…",
"avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=…",
"private": false,
"sec_uid": "MS4wLjABAAAAM3R2BtjzVT-uAtstkl2iugMzC6AtnpkojJbjiOdDDrdsTiTR75-8lyWJCY5VvDrZ",
"signature": "CEO of #RockTok\nLife's so much sweeter when you're not an asshole",
"url": "https://www.tiktok.com/@therock"
},
"author_stats": {
"diggCount": "25",
"followerCount": "80100000",
"followingCount": "0",
"friendCount": "0",
"heart": "689900000",
"heartCount": "689900000",
"videoCount": "586"
},
"challenges": [
{
"desc": null,
"id": "23971454",
"title": "faceoffchallenge"
},
{
"desc": null,
"id": "635060",
"title": "faceoff"
},
"… 1 more"
],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/35765ea83a8c40b895db7b88dad96cad_1635028296~tplv-tiktokx-origin.image?dr=9636&x-e…",
"create_time": "2021-10-23T22:31:32.000Z",
"create_time_unix": 1635028292,
"desc": "#FACEOFFCHALLENGE IS ON🔥🔥🔥Show us what someone says, does or encourages that sends you into OVERdrive👊🏾💪🏾 #faceoff #strangemusicinc",
"diversification_labels": null,
"duet_enabled": true,
"duration": 66,
"hashtags": [
"faceoffchallenge",
"faceoff",
"… 1 more"
],
"id": "7022393040451030278",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "Tech N9ne & Joey Cool & King Iso & Dwayne Johnson",
"id": "7016547803243022337",
"title": "Face Off - Dwayne Johnson"
},
"music_info": {
"album": "Face Off - Dwayne Johnson",
"cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/o8ea8AmF1GG4KxwI1fLl7IALGeAvIAFjfsAAhK~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4…",
"duration": 60,
"original": false,
"play_url": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oULlPria4KO2Gj7dInUfNmfFAvxeYwfL1gqAQG"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "584288",
"commentCount": "214300",
"diggCount": "17100000",
"playCount": "107700000",
"repostCount": "0",
"shareCount": "275400"
},
"stitch_enabled": true,
"suggested_words": null,
"url": "https://www.tiktok.com/@therock/video/7022393040451030278",
"video": {
"bitrate": 1487483,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 4 more"
],
"codec": "h264",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/35765ea83a8c40b895db7b88dad96cad_1635028296~tplv-tiktokx-origin.image?dr=9636&x-e…",
"definition": "540p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/98c9878e94444351bfa7bc91d583e63a/?a=1988&bti=ODszNWYuMDE…",
"dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/8f5f7ab1e94340f69106fe96a485c93d_1635028294~tplv-tiktokx-origin.image?dr=9636&x-e…",
"format": "mp4",
"height": 1024,
"origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/c8d8f9f0a81641a9b62d646881651294_1635028293~tplv-tiktokx-origin.image?dr=9636&x-e…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/8ab57f274ce74a2abfab36b443f320fd/?a=1988&bti=ODszNWYuMDE…",
"quality": "normal",
"ratio": "540p",
"size": 12299811,
"subtitles": [],
"width": 576
}
},
{
"ai_generated": null,
"author": {
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310268423383023658~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_…",
"id": "6911054760808875014",
"nickname": "ale",
"username": "thebadp1ace",
"verified": false
},
"author_info": {
"avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310268423383023658~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_to…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310268423383023658~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_to…",
"private": false,
"sec_uid": "MS4wLjABAAAAOaA1xb_q098LAV7lV57G6TD75WTm0gMhlOJ-ojqW-J1tjX_9blHKOEwBXAbsbsVB",
"signature": "24 | she/her\n💌 [email protected]",
"url": "https://www.tiktok.com/@thebadp1ace"
},
"author_stats": {
"diggCount": "140900",
"followerCount": "320600",
"followingCount": "459",
"friendCount": "0",
"heart": "21800000",
"heartCount": "21800000",
"videoCount": "394"
},
"challenges": [
{
"desc": null,
"id": "7008836944163504133",
"title": "thebadp1ace"
}
],
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/501bfa17e705479b8ffc192bed4d6a31~tplv-tiktokx-origin.image?dr=9636&x-expires=1792…",
"create_time": "2021-12-08T17:32:01.000Z",
"create_time_unix": 1638984721,
"desc": "it’s about drive #thebadp1ace",
"diversification_labels": null,
"duet_enabled": null,
"duration": 14,
"hashtags": [
"thebadp1ace"
],
"id": "7039385772222319878",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "Tech N9ne & Joey Cool & King Iso & Dwayne Johnson",
"id": "7016547803243022337",
"title": "Face Off - Dwayne Johnson"
},
"music_info": {
"album": "Face Off - Dwayne Johnson",
"cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/o8ea8AmF1GG4KxwI1fLl7IALGeAvIAFjfsAAhK~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4…",
"duration": 60,
"original": false,
"play_url": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oULlPria4KO2Gj7dInUfNmfFAvxeYwfL1gqAQG"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "733218",
"commentCount": "62300",
"diggCount": "16400000",
"playCount": "77200000",
"repostCount": "0",
"shareCount": "172100"
},
"stitch_enabled": null,
"suggested_words": null,
"url": "https://www.tiktok.com/@thebadp1ace/video/7039385772222319878",
"video": {
"bitrate": 2375372,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 3 more"
],
"codec": "h264",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/501bfa17e705479b8ffc192bed4d6a31~tplv-tiktokx-origin.image?dr=9636&x-expires=1792…",
"definition": "540p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/bfb9ccd779444fc0ad5193bbc5dcf832/?a=1988&bti=ODszNWYuMDE6&&…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/cb129ae3bbc24a46ad4f59a32c2abfde_1638984722~tplv-tiktokx-origin.image?dr=9636&x-e…",
"format": "mp4",
"height": 1024,
"origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/90dda5e599e7448f819cb45c0f19ae77_1638984722~tplv-tiktokx-origin.image?dr=9636&x-e…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/75bf6c19e40b4deda63b5b49813f1d30/?a=1988&bti=ODszNWYuMDE…",
"quality": "normal",
"ratio": "540p",
"size": 4211833,
"subtitles": [],
"width": 576
}
},
"… 28 more"
]
} Response fields (92)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.song_id | string |
$.videos | array |
$.videos[] | object | string |
$.videos[].ai_generated | null |
$.videos[].author | object |
$.videos[].author.avatar | string |
$.videos[].author.id | string |
$.videos[].author.nickname | string |
$.videos[].author.username | string |
$.videos[].author.verified | boolean |
$.videos[].author_info | object |
$.videos[].author_info.avatar_medium | string |
$.videos[].author_info.avatar_thumb | string |
$.videos[].author_info.private | boolean |
$.videos[].author_info.sec_uid | string |
$.videos[].author_info.signature | string |
$.videos[].author_info.url | string |
$.videos[].author_stats | object |
$.videos[].author_stats.diggCount | string |
$.videos[].author_stats.followerCount | string |
$.videos[].author_stats.followingCount | string |
$.videos[].author_stats.friendCount | string |
$.videos[].author_stats.heart | string |
$.videos[].author_stats.heartCount | string |
$.videos[].author_stats.videoCount | string |
$.videos[].challenges | array |
$.videos[].challenges[] | object | string |
$.videos[].challenges[].desc | null |
$.videos[].challenges[].id | string |
$.videos[].challenges[].title | string |
$.videos[].cover | string |
$.videos[].create_time | string |
$.videos[].create_time_unix | integer |
$.videos[].desc | string |
$.videos[].diversification_labels | null |
$.videos[].duet_enabled | boolean | null |
$.videos[].duration | integer |
$.videos[].hashtags | array |
$.videos[].hashtags[] | string |
$.videos[].id | string |
$.videos[].images | array |
$.videos[].is_ad | boolean |
$.videos[].location_created | null |
$.videos[].mentions | array |
$.videos[].music | object |
$.videos[].music.author | string |
$.videos[].music.id | string |
$.videos[].music.title | string |
$.videos[].music_info | object |
$.videos[].music_info.album | string |
$.videos[].music_info.cover | string |
$.videos[].music_info.duration | integer |
$.videos[].music_info.original | boolean |
$.videos[].music_info.play_url | string |
$.videos[].pinned | null |
$.videos[].poi | null |
$.videos[].private_item | boolean |
$.videos[].share_enabled | boolean |
$.videos[].stats | object |
$.videos[].stats.collectCount | string |
$.videos[].stats.commentCount | string |
$.videos[].stats.diggCount | string |
$.videos[].stats.playCount | string |
$.videos[].stats.repostCount | string |
$.videos[].stats.shareCount | string |
$.videos[].stitch_enabled | boolean | null |
$.videos[].suggested_words | null |
$.videos[].url | string |
$.videos[].video | object |
$.videos[].video.bitrate | integer |
$.videos[].video.bitrates | array |
$.videos[].video.bitrates[] | object | string |
$.videos[].video.bitrates[].… | string |
$.videos[].video.codec | string |
$.videos[].video.cover | string |
$.videos[].video.definition | string |
$.videos[].video.download_url | string |
$.videos[].video.dynamic_cover | string |
$.videos[].video.format | string |
$.videos[].video.height | integer |
$.videos[].video.origin_cover | string |
$.videos[].video.play_url | string |
$.videos[].video.quality | string |
$.videos[].video.ratio | string |
$.videos[].video.size | integer |
$.videos[].video.subtitles | array |
$.videos[].video.width | integer |