Trending Feed
GET/v1/tiktok/get-trending-feed1 credit
Returns the videos currently trending on TikTok's explore feed, as compact objects.
01Query parameters
| Name | Type | Description |
|---|---|---|
| trimoptional | boolean | Accepted for compatibility; the items are always compact.Default: false |
02Request
curl "https://api.scrapesocial.ai/v1/tiktok/get-trending-feed" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/tiktok/get-trending-feed
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"aweme_list": [
{
"aweme_id": "7698469111969418514",
"region": null,
"desc": "Bitanesigelirbintanesigelie",
"create_time": 1792439524,
"author_user_id": "7260176458528670725",
"author": {
"uid": "7260176458528670725",
"unique_id": "lavidalocaa35",
"nickname": "Su",
"avatar_thumb": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=c2f9162d&x-expires=1793120400&x-signature=y5pw%2BrSU6Z%2FIGgyHwZ3UmT8k8%2Fk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=c2f9162d&x-expires=1793120400&x-signature=y5pw%2BrSU6Z%2FIGgyHwZ3UmT8k8%2Fk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"avatar_medium": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=2fa2ab06&x-expires=1793120400&x-signature=4bimC43E024p3ICbPbfPVNOzfkM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=2fa2ab06&x-expires=1793120400&x-signature=4bimC43E024p3ICbPbfPVNOzfkM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"avatar_larger": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=a1903e8d&x-expires=1793120400&x-signature=7jtsxXU42wK54FZWNMaD%2BwPk9To%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=a1903e8d&x-expires=1793120400&x-signature=7jtsxXU42wK54FZWNMaD%2BwPk9To%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
}
},
"video": {
"has_watermark": true,
"duration": 5000,
"play_addr": {
"uri": "7698469111969418514",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYdsRqr91OCEE6eFBAIar5SfzETgKFQDImcBkn/?a=1988&bti=ODszNWYuMDE6&&bt=378&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=NTlmNWZoPGhlOjc7aGg8OkBpM288O3Y5cmY6ZTMzODczNEA0LmBiXzExNjQxYDNgNWItYSNtMzVzMmRzNl9hLS1kMWBzcw%3D%3D&expire=1793120935&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=19d…"
]
},
"download_addr": {
"uri": "7698469111969418514",
"url_list": [
""
]
},
"cover": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/okehIzBqBg0IZrRy2EsOfAVAWzLD1F5SncTdCE~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=488bRkZVocbV9JIT08ydPJe7zrM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/okehIzBqBg0IZrRy2EsOfAVAWzLD1F5SncTdCE~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=488bRkZVocbV9JIT08ydPJe7zrM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
]
},
"origin_cover": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owDh0E5ASId1zFbEVcZfrCbOET2yBRgeWqInAB~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=mI6AaLagfUONwdSZmawoikfyd8U%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owDh0E5ASId1zFbEVcZfrCbOET2yBRgeWqInAB~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=mI6AaLagfUONwdSZmawoikfyd8U%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
]
},
"dynamic_cover": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ooExEvREQBAfcQGsCqggCk9mcBFSr61Dnepzb5~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=IZF9oYzmei60MF9PHJjWB4h7Ro8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ooExEvREQBAfcQGsCqggCk9mcBFSr61Dnepzb5~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=IZF9oYzmei60MF9PHJjWB4h7Ro8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
]
},
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 400998,
"dub_infos": null,
"fps": 29,
"gear_name": "adapt_540_1",
"is_bytevc1": 1,
"play_addr": {
"data_size": 294082,
"file_cs": "c:0-6701-e193",
"file_hash": "e9eeda6ac377b813c55f1e6ce8120276",
"height": 954,
"uri": "7698469111969418514",
"url_key": "v1c044g50000dbb79cvog65sv8896lp0_bytevc1_540p_400998",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oY7NgILWYE4nfXttDRGAQlrzj6VAKCWIeOIJeH/?a=1988&bti=ODszNWYuMDE6&&bt=391&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=aThlZzdpNjU1ZjZoNTU8aUBpM288O3Y5cmY6ZTMzODczNEA1YDNiLzVeXi8xNl9hXmNiYSNtMzVzMmRzNl9hLS1kMWBzcw%3D%3D&expire=1793120935&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=387…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oY7NgILWYE4nfXttDRGAQlrzj6VAKCWIeOIJeH/?a=1988&bti=ODszNWYuMDE6&&bt=391&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=aThlZzdpNjU1ZjZoNTU8aUBpM288O3Y5cmY6ZTMzODczNEA1YDNiLzVeXi8xNl9hXmNiYSNtMzVzMmRzNl9hLS1kMWBzcw%3D%3D&expire=1793120935&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=387…"
],
"url_prefix": null,
"width": 540
},
"quality_type": 28,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 88345}, {\\\"time\\\": 2, \\\"offset\\\": 128137}, {\\\"time\\\": 3, \\\"offset\\\": 173535}, {\\\"time\\\": 4, \\\"offset\\\": 210523}, {\\\"time\\\": 5, \\\"offset\\\": 262664}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 92.12, \\\"v960\\\": 93.625, \\\"v864\\\": 93.836, \\\"v720\\\": 95.937}, \\\"ori\\\": {\\\"v1080\\\": 84.034, \\\"v960\\\": 86.775, \\\"v864\\\": 89.021, \\\"v720\\\": 91.51}}}\",\"ufq\":\"{\\\"enh\\\":6…"
},
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 387753,
"dub_infos": null,
"fps": 29,
"gear_name": "lower_540_0",
"is_bytevc1": 0,
"play_addr": {
"data_size": 284369,
"file_cs": "c:0-6452-8c60",
"file_hash": "c7f9fb5fb30c94fae39326d45a9bdc3b",
"height": 954,
"uri": "7698469111969418514",
"url_key": "v1c044g50000dbb79cvog65sv8896lp0_h264_540p_387753",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYdsRqr91OCEE6eFBAIar5SfzETgKFQDImcBkn/?a=1988&bti=ODszNWYuMDE6&&bt=378&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=NTlmNWZoPGhlOjc7aGg8OkBpM288O3Y5cmY6ZTMzODczNEA0LmBiXzExNjQxYDNgNWItYSNtMzVzMmRzNl9hLS1kMWBzcw%3D%3D&expire=1793120935&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=19d…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYdsRqr91OCEE6eFBAIar5SfzETgKFQDImcBkn/?a=1988&bti=ODszNWYuMDE6&&bt=378&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=NTlmNWZoPGhlOjc7aGg8OkBpM288O3Y5cmY6ZTMzODczNEA0LmBiXzExNjQxYDNgNWItYSNtMzVzMmRzNl9hLS1kMWBzcw%3D%3D&expire=1793120935&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=19d…"
],
"url_prefix": null,
"width": 540
},
"quality_type": 24,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 67134}, {\\\"time\\\": 2, \\\"offset\\\": 113978}, {\\\"time\\\": 3, \\\"offset\\\": 158885}, {\\\"time\\\": 4, \\\"offset\\\": 193215}, {\\\"time\\\": 5, \\\"offset\\\": 249803}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 85.076, \\\"v960\\\": 86.906, \\\"v864\\\": 89.53, \\\"v720\\\": 92.026}, \\\"ori\\\": {\\\"v1080\\\": 75.304, \\\"v960\\\": 77.549, \\\"v864\\\": 79.039, \\\"v720\\\": 83.469}}}\",\"ufq\":\"{\\\"enh\\\":…"
}
]
},
"music": {
"id": 7698469137450487000,
"id_str": "7698469137450486549",
"album": "",
"title": "orijinal ses",
"author": "Su",
"play_url": {
"uri": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-27dcd7/oYQB1jSCGnzDW9ogAAAJcnfTUdBFs6EqgIiIKe/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=amg5ZG45cnM6ZTMzODU8NEBpamg5ZG45cnM6ZTMzODU8NEBsXl9jMmRzNl9hLS1kMS1zYSNsXl9jMmRzNl9hLS1kMS1zcw%3D%3D&vvpl=1&l=20261026010850B9CD0AE582A2A9559272&VExpiration=1793034535&VSignature=RURM5zoqTT6tm7qQcWs2gw&btag=e00070000&…",
"url_list": [
"https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-27dcd7/oYQB1jSCGnzDW9ogAAAJcnfTUdBFs6EqgIiIKe/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=amg5ZG45cnM6ZTMzODU8NEBpamg5ZG45cnM6ZTMzODU8NEBsXl9jMmRzNl9hLS1kMS1zYSNsXl9jMmRzNl9hLS1kMS1zcw%3D%3D&vvpl=1&l=20261026010850B9CD0AE582A2A9559272&VExpiration=1793034535&VSignature=RURM5zoqTT6tm7qQcWs2gw&btag=e00070000&…"
]
},
"cover_large": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=a1903e8d&x-expires=1793120400&x-signature=7jtsxXU42wK54FZWNMaD%2BwPk9To%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=a1903e8d&x-expires=1793120400&x-signature=7jtsxXU42wK54FZWNMaD%2BwPk9To%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"cover_medium": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=2fa2ab06&x-expires=1793120400&x-signature=4bimC43E024p3ICbPbfPVNOzfkM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=2fa2ab06&x-expires=1793120400&x-signature=4bimC43E024p3ICbPbfPVNOzfkM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"cover_thumb": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=c2f9162d&x-expires=1793120400&x-signature=y5pw%2BrSU6Z%2FIGgyHwZ3UmT8k8%2Fk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/afa1a1c6525d317c0142dc7d7ce7f99d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=c2f9162d&x-expires=1793120400&x-signature=y5pw%2BrSU6Z%2FIGgyHwZ3UmT8k8%2Fk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"is_original_sound": true,
"is_commerce_music": true,
"duration": 5,
"duration_high_precision": {
"audition_duration_precision": 5,
"duration_precision": 5,
"shoot_duration_precision": 5,
"video_duration_precision": 5
}
},
"statistics": {
"aweme_id": "7698469111969418514",
"play_count": 1500000,
"digg_count": 127800,
"comment_count": 146,
"share_count": 14700,
"collect_count": 10288,
"forward_count": 0,
"repost_count": 0
},
"image_post_info": {
"image_post_cover": {
"bitrate_images": [],
"display_image": {
"height": 853,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 480
},
"owner_watermark_image": {
"height": 2080,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 1170
},
"thumbnail": {
"height": 2080,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 1170
}
},
"music_volume": 0.5,
"post_extra": "{\"photo_cover_shrink\":true,\"photo_blurhash\":false,\"photo_progressive\":false}",
"title": "",
"translation_info": {
"image_major_language": "zh-Hans",
"target_language": "",
"translatable": false
}
},
"share_info": {
"share_url": "https://www.tiktok.com/@lavidalocaa35/video/7698469111969418514"
},
"poi_data": {
"address_info": {}
},
"anchors": null,
"commerce_info": null,
"item_comment_settings": 0,
"is_ad": false,
"is_eligible_for_commission": false,
"is_paid_partnership": null,
"shop_product_url": null,
"create_time_utc": "2026-10-19T19:52:04.000Z",
"url": "https://www.tiktok.com/@lavidalocaa35/video/7698469111969418514"
},
{
"aweme_id": "7697691665829580050",
"region": null,
"desc": "Bi bu eksikti #kesfettt #keşfet #komedi #öneçıkar #fy ",
"create_time": 1792258515,
"author_user_id": "7170810476681544710",
"author": {
"uid": "7170810476681544710",
"unique_id": "meromedii",
"nickname": "meromedi",
"avatar_thumb": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=afb1696b&x-expires=1793120400&x-signature=coqNzlMmUrPs%2BkGYrTiaS1KjAhM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=afb1696b&x-expires=1793120400&x-signature=coqNzlMmUrPs%2BkGYrTiaS1KjAhM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"avatar_medium": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=4b0f734a&x-expires=1793120400&x-signature=ow%2BYRxwPGdUupGHcsIdlADs%2F9y4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=4b0f734a&x-expires=1793120400&x-signature=ow%2BYRxwPGdUupGHcsIdlADs%2F9y4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"avatar_larger": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6cd90611&x-expires=1793120400&x-signature=OeZ%2F1yE%2BvOzxDF2EF8QnpPfntWE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6cd90611&x-expires=1793120400&x-signature=OeZ%2F1yE%2BvOzxDF2EF8QnpPfntWE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
}
},
"video": {
"has_watermark": true,
"duration": 6000,
"play_addr": {
"uri": "7697691665829580050",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oUA4Iiku1tY9BsBAxVtaTQEHxulODJXtIEiPd/?a=1988&bti=ODszNWYuMDE6&&bt=567&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=ZTo1ODk7NTtlM2k5ZWZlaUBpamdxPHI5cjx1ZTMzODczNEAzMTUxYTIuNmExLWEtYjY1YSNfXzQ1MmQ0LzZhLS1kMTFzcw%3D%3D&expire=1793120936&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=15a4…"
]
},
"download_addr": {
"uri": "7697691665829580050",
"url_list": [
""
]
},
"cover": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owDIes0dEvLIoNpE9TEGeDUjOjALAA2AA2AVIf~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=f6YQ%2BTbhdlC9R0UbQxNvH%2BPlsMA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/owDIes0dEvLIoNpE9TEGeDUjOjALAA2AA2AVIf~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=f6YQ%2BTbhdlC9R0UbQxNvH%2BPlsMA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
]
},
"origin_cover": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/okA9xXtTtQA1BIc1dSPBaszFEiYnkiBIxVOJ4~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=aMbBfeaaKjKZ%2FBnEiE3chMGD%2F8A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/okA9xXtTtQA1BIc1dSPBaszFEiYnkiBIxVOJ4~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=aMbBfeaaKjKZ%2FBnEiE3chMGD%2F8A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
]
},
"dynamic_cover": {
"uri": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owDIes0dEvLIoNpE9TEGeDUjOjALAA2AA2AVIf~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=bCnG8%2FeZkEua3xsNxMtMYFGyoGY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my",
"url_list": [
"https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/owDIes0dEvLIoNpE9TEGeDUjOjALAA2AA2AVIf~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=bCnG8%2FeZkEua3xsNxMtMYFGyoGY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
]
},
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 581570,
"dub_infos": null,
"fps": 30,
"gear_name": "lower_540_0",
"is_bytevc1": 0,
"play_addr": {
"data_size": 467728,
"file_cs": "c:0-6999-73b2",
"file_hash": "0fbc6ab94a6948dab773d57191bfa162",
"height": 1024,
"uri": "7697691665829580050",
"url_key": "v14044g50000db9r297og65o897nbdbg_h264_540p_581570",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oUA4Iiku1tY9BsBAxVtaTQEHxulODJXtIEiPd/?a=1988&bti=ODszNWYuMDE6&&bt=567&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=ZTo1ODk7NTtlM2k5ZWZlaUBpamdxPHI5cjx1ZTMzODczNEAzMTUxYTIuNmExLWEtYjY1YSNfXzQ1MmQ0LzZhLS1kMTFzcw%3D%3D&expire=1793120936&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=15a4…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oUA4Iiku1tY9BsBAxVtaTQEHxulODJXtIEiPd/?a=1988&bti=ODszNWYuMDE6&&bt=567&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=ZTo1ODk7NTtlM2k5ZWZlaUBpamdxPHI5cjx1ZTMzODczNEAzMTUxYTIuNmExLWEtYjY1YSNfXzQ1MmQ0LzZhLS1kMTFzcw%3D%3D&expire=1793120936&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=15a4…"
],
"url_prefix": null,
"width": 576
},
"quality_type": 24,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 151169}, {\\\"time\\\": 2, \\\"offset\\\": 212128}, {\\\"time\\\": 3, \\\"offset\\\": 297078}, {\\\"time\\\": 4, \\\"offset\\\": 372307}, {\\\"time\\\": 5, \\\"offset\\\": 402884}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 86.595, \\\"v960\\\": 91.054, \\\"v864\\\": 93.181, \\\"v720\\\": 95.438}, \\\"ori\\\": {\\\"v1080\\\": 77.987, \\\"v960\\\": 80.319, \\\"v864\\\": 82.34, \\\"v720\\\": 86.939}}}\",\"ufq\":\"{\\\"enh\\\"…"
},
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 436438,
"dub_infos": null,
"fps": 30,
"gear_name": "adapt_lower_720_1",
"is_bytevc1": 1,
"play_addr": {
"data_size": 351006,
"file_cs": "c:0-7148-2d64",
"file_hash": "04eb8cd2b28b17a62ae2fa4838c05122",
"height": 1280,
"uri": "7697691665829580050",
"url_key": "v14044g50000db9r297og65o897nbdbg_bytevc1_720p_436438",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ooJaQYOu7TxVx2FQiiCPtEI949zkW1BBtAEXA/?a=1988&bti=ODszNWYuMDE6&&bt=426&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=N2Q2ZDg8OTw1NDk6OmVoZkBpamdxPHI5cjx1ZTMzODczNEBeYl82NF5hXjAxYjViNC5eYSNfXzQ1MmQ0LzZhLS1kMTFzcw%3D%3D&expire=1793120936&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=e198…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/ooJaQYOu7TxVx2FQiiCPtEI949zkW1BBtAEXA/?a=1988&bti=ODszNWYuMDE6&&bt=426&ft=-Csk_mXMPD12NflyLn-Ux7JFbY6e3wv257cAp&mime_type=video_mp4&rc=N2Q2ZDg8OTw1NDk6OmVoZkBpamdxPHI5cjx1ZTMzODczNEBeYl82NF5hXjAxYjViNC5eYSNfXzQ1MmQ0LzZhLS1kMTFzcw%3D%3D&expire=1793120936&l=20261026010850B9CD0AE582A2A9559272&ply_type=2&policy=2&signature=e198…"
],
"url_prefix": null,
"width": 720
},
"quality_type": 14,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 131524}, {\\\"time\\\": 2, \\\"offset\\\": 161809}, {\\\"time\\\": 3, \\\"offset\\\": 230373}, {\\\"time\\\": 4, \\\"offset\\\": 283343}, {\\\"time\\\": 5, \\\"offset\\\": 302189}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 95.896, \\\"v960\\\": 97.767, \\\"v864\\\": 98.044, \\\"v720\\\": 99.158}, \\\"ori\\\": {\\\"v1080\\\": 85.402, \\\"v960\\\": 88.76, \\\"v864\\\": 90.714, \\\"v720\\\": 94.154}}}\",\"ufq\":\"{\\\"enh\\\"…"
}
]
},
"music": {
"id": 7697691706879266000,
"id_str": "7697691706879265552",
"album": "",
"title": "orijinal ses",
"author": "meromedi",
"play_url": {
"uri": "https://v16m.tiktokcdn.com/69db9da4a20f7aaf0d703e61ae81f0be/6adf8928/video/tos/alisg/tos-alisg-v-27dcd7/osE5PtCBATdDXl9Ypa1EO9A4RDA1AxziA4siU/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=anFpeXc5cm91ZTMzODU8NEBpanFpeXc5cm91ZTMzODU8NEBwZDVtMmQ0MDZhLS1kMS1zYSNwZDVtMmQ0MDZhLS1kMS1zcw%3D%3D&vvpl=1&l=20261026010850B9CD0AE582A2A9559272&btag=e00070000&sp_exp=hash_v0",
"url_list": [
"https://v16m.tiktokcdn.com/69db9da4a20f7aaf0d703e61ae81f0be/6adf8928/video/tos/alisg/tos-alisg-v-27dcd7/osE5PtCBATdDXl9Ypa1EO9A4RDA1AxziA4siU/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=anFpeXc5cm91ZTMzODU8NEBpanFpeXc5cm91ZTMzODU8NEBwZDVtMmQ0MDZhLS1kMS1zYSNwZDVtMmQ0MDZhLS1kMS1zcw%3D%3D&vvpl=1&l=20261026010850B9CD0AE582A2A9559272&btag=e00070000&sp_exp=hash_v0"
]
},
"cover_large": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6cd90611&x-expires=1793120400&x-signature=OeZ%2F1yE%2BvOzxDF2EF8QnpPfntWE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6cd90611&x-expires=1793120400&x-signature=OeZ%2F1yE%2BvOzxDF2EF8QnpPfntWE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"cover_medium": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=4b0f734a&x-expires=1793120400&x-signature=ow%2BYRxwPGdUupGHcsIdlADs%2F9y4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=4b0f734a&x-expires=1793120400&x-signature=ow%2BYRxwPGdUupGHcsIdlADs%2F9y4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"cover_thumb": {
"uri": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=afb1696b&x-expires=1793120400&x-signature=coqNzlMmUrPs%2BkGYrTiaS1KjAhM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/ae9c12745a744f5c0fed7d7c65c11ec3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=afb1696b&x-expires=1793120400&x-signature=coqNzlMmUrPs%2BkGYrTiaS1KjAhM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"height": 720,
"width": 720
},
"is_original_sound": true,
"is_commerce_music": true,
"duration": 6,
"duration_high_precision": {
"audition_duration_precision": 6,
"duration_precision": 6,
"shoot_duration_precision": 6,
"video_duration_precision": 6
}
},
"statistics": {
"aweme_id": "7697691665829580050",
"play_count": 1200000,
"digg_count": 57900,
"comment_count": 539,
"share_count": 6010,
"collect_count": 2562,
"forward_count": 0,
"repost_count": 0
},
"image_post_info": {
"image_post_cover": {
"bitrate_images": [],
"display_image": {
"height": 853,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 480
},
"owner_watermark_image": {
"height": 2080,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 1170
},
"thumbnail": {
"height": 2080,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 1170
}
},
"music_volume": 0.5,
"post_extra": "{\"photo_cover_shrink\":true,\"photo_blurhash\":false,\"photo_progressive\":false}",
"title": "",
"translation_info": {
"image_major_language": "tr",
"target_language": "",
"translatable": false
}
},
"share_info": {
"share_url": "https://www.tiktok.com/@meromedii/video/7697691665829580050"
},
"poi_data": {
"address_info": {}
},
"anchors": null,
"commerce_info": null,
"item_comment_settings": 0,
"is_ad": false,
"is_eligible_for_commission": false,
"is_paid_partnership": null,
"shop_product_url": null,
"create_time_utc": "2026-10-17T17:35:15.000Z",
"url": "https://www.tiktok.com/@meromedii/video/7697691665829580050"
}
]
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
Videos are in `aweme_list`, about 12 per call, each with author, video, music, statistics and URL. There is no paging; each call returns the current selection. `region` is null on these items, and `region` as a parameter has no effect.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.