API referenceTikTok
TikTok music posts
The videos using a given sound (TikTok's sound page), paginated.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 2.4s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-music-posts-v4" \ -H "Content-Type: application/json" \ -d '{ "music": "7002634556977908485", "cursor": "0", "count": 30 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "aweme_list": [ { "anchors": null, "author": { "avatar_larger": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff9e02109b824cb6757b43279e970164~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0025f1ee&x-expires=1787572800&x-signature=7rMkaOqmnzyjn8LZDZMtbq%2BTD64%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&sc=avatar&s=MUSIC_AWEME", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff9e02109b824cb6757b43279e970164~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0025f1ee&x-expires=1787572800&x-signature=7rMkaOqmnzyjn8LZDZMtbq%2BTD64%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&sc=avatar&s=MUSIC_AWEME" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff9e02109b824cb6757b43279e970164~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0025f1ee&x-expires=1787572800&x-signature=7rMkaOqmnzyjn8LZDZMtbq%2BTD64%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&sc=avatar&s=MUSIC_AWEME", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff9e02109b824cb6757b43279e970164~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0025f1ee&x-expires=1787572800&x-signature=7rMkaOqmnzyjn8LZDZMtbq%2BTD64%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&sc=avatar&s=MUSIC_AWEME" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff9e02109b824cb6757b43279e970164~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0025f1ee&x-expires=1787572800&x-signature=7rMkaOqmnzyjn8LZDZMtbq%2BTD64%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&sc=avatar&s=MUSIC_AWEME", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ff9e02109b824cb6757b43279e970164~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0025f1ee&x-expires=1787572800&x-signature=7rMkaOqmnzyjn8LZDZMtbq%2BTD64%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&sc=avatar&s=MUSIC_AWEME" ], "url_prefix": null, "width": null }, "events": null, "language": null, "nickname": "Yarelyly", "region": "VE", "sec_uid": null, "short_id": null, "signature": null, "social_info": null, "uid": "6764339504008446982", "unique_id": "yarelyly" }, "author_user_id": "6764339504008446982", "aweme_id": "7014949174089125125", "aweme_type": 0, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20260823200223AC2AFF931548B0CF9AE5\"}", "with_comment_filter_words": false }, "create_time": 1633295132, "create_time_utc": "2021-10-03T21:05:32.000Z", "desc": "Tu 4@ se quiere quedar encerrado en una habitación contigo 🙊 #yarelyly", "desc_language": null, "image_post_info": null, "is_ad": false, "is_eligible_for_commission": null, "is_nff_or_nr": false, "is_paid_partnership": null, "is_top": 0, "item_comment_settings": 0, "media_id": "v09044g40000c5d1kirc77uf6a6olms0", "music": null, "region": "VE", "shop_product_url": null, "statistics": { "aweme_id": "7014949174089125125", "collect_count": 11940, "comment_count": 1383, "digg_count": 327243, "download_count": 11952, "forward_count": null, "lose_comment_count": null, "lose_count": null, "play_count": 2584477, "repost_count": null, "share_count": 4125, "whatsapp_share_count": null }, "url": "https://www.tiktok.com/@yarelyly/video/7014949174089125125", "video": { "cover": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/a68fea2b2cf04086992a8a3e2a296a61~tplv-tiktokx-cropcenter-q:300:400:q70.webp?dr=14782&refresh_token=5e3216f0&x-expires=1787572800&x-signature=IgSJbaD2QMP%2FupHrNDT14zCqxio%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_video&s=MUSIC_AWEME&sc… (+6 chars)", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/a68fea2b2cf04086992a8a3e2a296a61~tplv-tiktokx-cropcenter-q:300:400:q70.webp?dr=14782&refresh_token=5e3216f0&x-expires=1787572800&x-signature=IgSJbaD2QMP%2FupHrNDT14zCqxio%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_video&s=MUSIC_AWEME&sc… (+6 chars)" ], "url_prefix": null, "width": null }, "data_size": 1122002, "download_addr": { "height": null, "uri": "https://v19.tiktokcdn.com/ad6c986ef290a0c677a0a9a056a3e78d/6a8c32d7/video/tos/maliva/tos-maliva-ve-0068c801-us/70b68cae2d2d460ea7c00aee935d7b1a/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1247&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=OjNkOWk0N2Q2ZmYzNDU7NkBpM3ByZGk6Zmw0ODMzNzczM0AtMl4zXy8wNV4… (+100 chars)", "url_list": [ "https://v19.tiktokcdn.com/ad6c986ef290a0c677a0a9a056a3e78d/6a8c32d7/video/tos/maliva/tos-maliva-ve-0068c801-us/70b68cae2d2d460ea7c00aee935d7b1a/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1247&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=OjNkOWk0N2Q2ZmYzNDU7NkBpM3ByZGk6Zmw0ODMzNzczM0AtMl4zXy8wNV4… (+100 chars)" ], "url_prefix": null, "width": null }, "duration": 7, "dynamic_cover": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/114fa5c90e98427d8dccc28b06719d0a_1633295133~tplv-tiktokx-origin.image?dr=1364&refresh_token=683c763d&x-expires=1787572800&x-signature=Kqjc2GZipgYlMFPtvU1A20UC35E%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=f6441914&idc=my&sc=dynamic_cover&biz_tag=tt_video&s=MUSIC_… (+5 chars)", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/114fa5c90e98427d8dccc28b06719d0a_1633295133~tplv-tiktokx-origin.image?dr=1364&refresh_token=683c763d&x-expires=1787572800&x-signature=Kqjc2GZipgYlMFPtvU1A20UC35E%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=f6441914&idc=my&sc=dynamic_cover&biz_tag=tt_video&s=MUSIC_… (+5 chars)" ], "url_prefix": null, "width": null }, "height": null, "origin_cover": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/8014300fd390454ea573c5bd26303448_1633295135~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=c4dd8897&x-expires=1787572800&x-signature=7xi%2FlKXh3VPLBxegDMoLQQMtNis%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_video&s=MUSIC_… (+19 chars)", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068/8014300fd390454ea573c5bd26303448_1633295135~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=c4dd8897&x-expires=1787572800&x-signature=7xi%2FlKXh3VPLBxegDMoLQQMtNis%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_video&s=MUSIC_… (+19 chars)" ], "url_prefix": null, "width": null }, "play_addr": { "height": null, "uri": "https://v19.tiktokcdn.com/8eb1f801beb729a8eae6a7b1e52f5083/6a8c32d7/video/tos/useast2a/tos-useast2a-ve-0068c001/02c44b704bbc47a89973defae608799f/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1226&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=N2k3ZmQ6OTpoODQ2ZTVpPEBpM3ByZGk6Zmw0ODMzNzczM0AuLy4wNS5eNj… (+101 chars)", "url_list": [ "https://v19.tiktokcdn.com/8eb1f801beb729a8eae6a7b1e52f5083/6a8c32d7/video/tos/useast2a/tos-useast2a-ve-0068c001/02c44b704bbc47a89973defae608799f/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1226&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=N2k3ZmQ6OTpoODQ2ZTVpPEBpM3ByZGk6Zmw0ODMzNzczM0AuLy4wNS5eNj… (+101 chars)" ], "url_prefix": null, "width": null }, "watermark_data_size": 1141387, "width": null } }, { "anchors": null, "author": { "avatar_larger": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2e2a48b2722173e93563c5f4057a156f~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=47d98801&x-expires=1787572800&x-signature=eD55%2BV5m5sEDItWURjEm78gtn3g%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&s=MUSIC_AWEME&sc=avatar", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2e2a48b2722173e93563c5f4057a156f~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=47d98801&x-expires=1787572800&x-signature=eD55%2BV5m5sEDItWURjEm78gtn3g%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&s=MUSIC_AWEME&sc=avatar" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2e2a48b2722173e93563c5f4057a156f~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=47d98801&x-expires=1787572800&x-signature=eD55%2BV5m5sEDItWURjEm78gtn3g%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&s=MUSIC_AWEME&sc=avatar", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2e2a48b2722173e93563c5f4057a156f~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=47d98801&x-expires=1787572800&x-signature=eD55%2BV5m5sEDItWURjEm78gtn3g%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&s=MUSIC_AWEME&sc=avatar" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2e2a48b2722173e93563c5f4057a156f~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=47d98801&x-expires=1787572800&x-signature=eD55%2BV5m5sEDItWURjEm78gtn3g%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&s=MUSIC_AWEME&sc=avatar", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2e2a48b2722173e93563c5f4057a156f~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=47d98801&x-expires=1787572800&x-signature=eD55%2BV5m5sEDItWURjEm78gtn3g%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=f6441914&idc=my&s=MUSIC_AWEME&sc=avatar" ], "url_prefix": null, "width": null }, "events": null, "language": null, "nickname": "Staryuuki", "region": "US", "sec_uid": null, "short_id": null, "signature": null, "social_info": null, "uid": "6710553772177343493", "unique_id": "staryuukiii" }, "author_user_id": "6710553772177343493", "aweme_id": "7006709969886268677", "aweme_type": 0, "commerce_info": { "adv_promotable": false, "auction_ad_invited": false, "branded_content_type": 0, "is_diversion_ad": 0, "organic_log_extra": "{\"req_id\":\"20260823200223AC2AFF931548B0CF9AE5\"}", "with_comment_filter_words": false }, "create_time": 1631376793, "create_time_utc": "2021-09-11T16:13:13.000Z", "desc": "#parati #fypシ Ayer fue un día grandioso 😍✨♥️", "desc_language": null, "image_post_info": null, "is_ad": false, "is_eligible_for_commission": null, "is_nff_or_nr": false, "is_paid_partnership": null, "is_top": 0, "item_comment_settings": 0, "media_id": "v09044g40000c4udaobc77udm97qf1hg", "music": null, "region": "US", "shop_product_url": null, "statistics": { "aweme_id": "7006709969886268677", "collect_count": 5204, "comment_count": 1228, "digg_count": 201553, "download_count": 7525, "forward_count": null, "lose_comment_count": null, "lose_count": null, "play_count": 1781520, "repost_count": null, "share_count": 1412, "whatsapp_share_count": null }, "url": "https://www.tiktok.com/@staryuukiii/video/7006709969886268677", "video": { "cover": { "height": null, "uri": "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/1dfffcf58e1040359821993d2424388c_1631376795~tplv-tiktokx-cropcenter-q:300:400:q70.webp?dr=14782&refresh_token=61a239c8&x-expires=1787572800&x-signature=mi%2FopU%2B1PKNG6pLwbdCZdu%2Fz%2BtU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_v… (+27 chars)", "url_list": [ "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/1dfffcf58e1040359821993d2424388c_1631376795~tplv-tiktokx-cropcenter-q:300:400:q70.webp?dr=14782&refresh_token=61a239c8&x-expires=1787572800&x-signature=mi%2FopU%2B1PKNG6pLwbdCZdu%2Fz%2BtU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_v… (+27 chars)" ], "url_prefix": null, "width": null }, "data_size": 1242785, "download_addr": { "height": null, "uri": "https://v19.tiktokcdn.com/f0fa9cc0f22cdd81f8d3fa50b8337fd2/6a8c32d7/video/tos/alisg/tos-alisg-ve-37c799-sg/43691d45cf90449ba70438500ee3da66/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1363&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=ZDQ2ZTlkOzM7Zjs7NmYzZUBpajR0PGc6ZnJnNzMzNzczM0BgNV4yMWNiXzQxLzY… (+96 chars)", "url_list": [ "https://v19.tiktokcdn.com/f0fa9cc0f22cdd81f8d3fa50b8337fd2/6a8c32d7/video/tos/alisg/tos-alisg-ve-37c799-sg/43691d45cf90449ba70438500ee3da66/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1363&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=ZDQ2ZTlkOzM7Zjs7NmYzZUBpajR0PGc6ZnJnNzMzNzczM0BgNV4yMWNiXzQxLzY… (+96 chars)" ], "url_prefix": null, "width": null }, "duration": 7, "dynamic_cover": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/b4fda18cab254e3b99c8956fe49a4f45_1631376794~tplv-tiktokx-origin.image?dr=1364&refresh_token=c2ddc4bd&x-expires=1787572800&x-signature=tWoVU028QJMOhNC4q3P%2B7uAo1Xw%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_video&s=MUSIC_AWEME&sc=dy… (+11 chars)", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/b4fda18cab254e3b99c8956fe49a4f45_1631376794~tplv-tiktokx-origin.image?dr=1364&refresh_token=c2ddc4bd&x-expires=1787572800&x-signature=tWoVU028QJMOhNC4q3P%2B7uAo1Xw%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=f6441914&idc=my&biz_tag=tt_video&s=MUSIC_AWEME&sc=dy… (+11 chars)" ], "url_prefix": null, "width": null }, "height": null, "origin_cover": { "height": null, "uri": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/a237b92850f94761958bc31cbe58df13_1631376794~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=bbfe05a3&x-expires=1787572800&x-signature=R1lNw35UHLsVaEAxvEcngcUQIys%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=f6441914&idc=my&sc=feed_cover&biz_tag=t… (+21 chars)", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/a237b92850f94761958bc31cbe58df13_1631376794~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=bbfe05a3&x-expires=1787572800&x-signature=R1lNw35UHLsVaEAxvEcngcUQIys%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=f6441914&idc=my&sc=feed_cover&biz_tag=t… (+21 chars)" ], "url_prefix": null, "width": null }, "play_addr": { "height": null, "uri": "https://v19.tiktokcdn.com/b1ab76cad29cca04d3f12ce980f9bac9/6a8c32d7/video/tos/alisg/tos-alisg-ve-37c799-sg/e8f843d725074626bdc2ec2f31fde09b/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1358&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=NzY1ZTk6OztpPDNmNDM7aUBpajR0PGc6ZnJnNzMzNzczM0AwXzM2Y2NjNjAxMC8… (+96 chars)", "url_list": [ "https://v19.tiktokcdn.com/b1ab76cad29cca04d3f12ce980f9bac9/6a8c32d7/video/tos/alisg/tos-alisg-ve-37c799-sg/e8f843d725074626bdc2ec2f31fde09b/?a=1233&bti=O3YpOjQ0Zik3OjlmOm0uMjM6ZDQ0MDo%3D&&bt=1358&ft=XsFb_qT0m0LPD12MlDsI3wUOBVM2MeF~O5&mime_type=video_mp4&rc=NzY1ZTk6OztpPDNmNDM7aUBpajR0PGc6ZnJnNzMzNzczM0AwXzM2Y2NjNjAxMC8… (+96 chars)" ], "url_prefix": null, "width": null }, "watermark_data_size": 1247456, "width": null } }, "… 3 more items in the full response" ], "can_pin_video": false, "cursor": "12", "extra": null, "has_more": true, "log_pb": null, "music_id": "7002634556977908485", "need_lazy_loading": false, "status_code": 0, "status_msg": "" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-music-posts-v4", "billable": true, "duration_ms": 1554 }}