Hashtag Videos
GET/v1/tiktok/search/hashtag1 credit
Returns videos posted under a TikTok hashtag, about 20 per page.
01Query parameters
| Name | Type | Description |
|---|---|---|
| hashtagrequired | string | The hashtag, with or without `#`. |
| cursoroptional | integer | The `cursor` value of the previous page, to get the next one. |
| trimoptional | boolean | Accepted for compatibility; this endpoint always returns full video objects.Default: false |
02Request
curl "https://api.scrapesocial.ai/v1/tiktok/search/hashtag?hashtag=dogs" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/tiktok/search/hashtag?hashtag=dogs
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"has_more": 1,
"cursor": 20,
"status_code": 0,
"aweme_list": [
{
"added_sound_music_info": {
"author": "WhiskerWonders",
"cover_large": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=958edb0c&x-expires=1793120400&x-signature=VOVXUnLBuvRwwYZTUSK6kp%2BiFdg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=42d8cffd&x-expires=1793120400&x-signature=kUQpWI8Jvz2w04Me4dl8xBabyys%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=a31a7b5d&x-expires=1793120400&x-signature=TltN8VJDBoyAGEFsv54vYrpgkT4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"duration": 61,
"duration_high_precision": {
"audition_duration_precision": 61,
"duration_precision": 61,
"shoot_duration_precision": 61,
"video_duration_precision": 61
},
"id": "7619777511311821600",
"id_str": "7619777511311821600",
"is_commerce_music": true,
"is_original_sound": true,
"mid": "7619777511311821600",
"play_url": {
"height": 720,
"uri": "https://v16m.tiktokcdn.com/95fe3ec8199194720ff0bb77d9320850/6adf8961/video/tos/useast2a/tos-useast2a-v-2370-euttp/ocQkpTIAYCJLeIc4FkmiUfeTAaGjNGAIqA0mYe/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=ajs3NG85cmxoOTMzZjU8NUBpajs3NG85cmxoOTMzZjU8NUBraTQwMmRjM3NhLS1kMTNzYSNraTQwMmRjM3NhLS1kMTNzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&btag=e00050000&sp_e…",
"url_list": [
"https://v16m.tiktokcdn.com/95fe3ec8199194720ff0bb77d9320850/6adf8961/video/tos/useast2a/tos-useast2a-v-2370-euttp/ocQkpTIAYCJLeIc4FkmiUfeTAaGjNGAIqA0mYe/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=ajs3NG85cmxoOTMzZjU8NUBpajs3NG85cmxoOTMzZjU8NUBraTQwMmRjM3NhLS1kMTNzYSNraTQwMmRjM3NhLS1kMTNzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&btag=e00050000&sp_e…"
],
"url_prefix": null,
"width": 720
},
"shoot_duration": 61,
"title": "Originalton"
},
"author": {
"avatar_larger": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=958edb0c&x-expires=1793120400&x-signature=VOVXUnLBuvRwwYZTUSK6kp%2BiFdg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"avatar_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=42d8cffd&x-expires=1793120400&x-signature=kUQpWI8Jvz2w04Me4dl8xBabyys%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"avatar_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=a31a7b5d&x-expires=1793120400&x-signature=TltN8VJDBoyAGEFsv54vYrpgkT4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"avatar_uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"follower_count": 28900,
"following_count": 81,
"nickname": "WhiskerWonders",
"sec_uid": "MS4wLjABAAAAgrpFT-2qLDRQyqTzQtCZDpFO6_1VGJmxmJLyZ8uJDa0Pw5qSPFLr0UJ0ki0kaawm",
"secret": 0,
"signature": "Animal lover🥰",
"uid": "7609302649335022615",
"unique_id": "whiskerwonders107"
},
"author_user_id": 7609302649335023000,
"aweme_id": "7619777492936576288",
"aweme_type": 0,
"content_type": "video",
"create_time": 1774117702,
"desc": "Why are puppies always so cute🥰😁 #puppies #cutedog #animal #core #petsoftiktok ",
"desc_language": "en",
"group_id": "7619777492936576288",
"is_ads": false,
"is_top": 0,
"item_comment_settings": 0,
"music": {
"author": "WhiskerWonders",
"cover_large": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=958edb0c&x-expires=1793120400&x-signature=VOVXUnLBuvRwwYZTUSK6kp%2BiFdg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=42d8cffd&x-expires=1793120400&x-signature=kUQpWI8Jvz2w04Me4dl8xBabyys%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4ec5017d43ec5f418dc41f32a3680311~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=a31a7b5d&x-expires=1793120400&x-signature=TltN8VJDBoyAGEFsv54vYrpgkT4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"duration": 61,
"duration_high_precision": {
"audition_duration_precision": 61,
"duration_precision": 61,
"shoot_duration_precision": 61,
"video_duration_precision": 61
},
"id": "7619777511311821600",
"id_str": "7619777511311821600",
"is_commerce_music": true,
"is_original_sound": true,
"mid": "7619777511311821600",
"play_url": {
"height": 720,
"uri": "https://v16m.tiktokcdn.com/95fe3ec8199194720ff0bb77d9320850/6adf8961/video/tos/useast2a/tos-useast2a-v-2370-euttp/ocQkpTIAYCJLeIc4FkmiUfeTAaGjNGAIqA0mYe/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=ajs3NG85cmxoOTMzZjU8NUBpajs3NG85cmxoOTMzZjU8NUBraTQwMmRjM3NhLS1kMTNzYSNraTQwMmRjM3NhLS1kMTNzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&btag=e00050000&sp_e…",
"url_list": [
"https://v16m.tiktokcdn.com/95fe3ec8199194720ff0bb77d9320850/6adf8961/video/tos/useast2a/tos-useast2a-v-2370-euttp/ocQkpTIAYCJLeIc4FkmiUfeTAaGjNGAIqA0mYe/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=ajs3NG85cmxoOTMzZjU8NUBpajs3NG85cmxoOTMzZjU8NUBraTQwMmRjM3NhLS1kMTNzYSNraTQwMmRjM3NhLS1kMTNzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&btag=e00050000&sp_e…"
],
"url_prefix": null,
"width": 720
},
"shoot_duration": 61,
"title": "Originalton"
},
"share_url": "https://www.tiktok.com/@whiskerwonders107/video/7619777492936576288",
"statistics": {
"aweme_id": "7619777492936576288",
"collect_count": 126055,
"comment_count": 3535,
"digg_count": 2200000,
"play_count": 11600000,
"repost_count": 0,
"share_count": 431200
},
"status": {
"allow_comment": true,
"allow_share": true,
"aweme_id": "7619777492936576288",
"in_reviewing": false,
"is_prohibited": false,
"private_status": 0,
"self_see": false
},
"text_extra": [
{
"end": 43,
"hashtag_name": "puppies",
"is_commerce": false,
"start": 35,
"type": 1
},
{
"end": 52,
"hashtag_name": "cutedog",
"is_commerce": false,
"start": 44,
"type": 1
}
],
"video": {
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 1076401,
"dub_infos": null,
"fps": 30,
"gear_name": "adapt_lowest_1080_1",
"is_bytevc1": 1,
"play_addr": {
"data_size": 8300941,
"file_cs": "c:0-52582-0bbb",
"file_hash": "bc015fe96c29ad24cb966e2501bbd54c",
"height": 1920,
"uri": "v26044gc0000d6ve6avog65ln38hrmd0",
"url_key": "v26044gc0000d6ve6avog65ln38hrmd0_bytevc1_1080p_1076401",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oAOf8AMfRvsNlWGjmxzXZAYRAAH8GofifqtcQu/?a=1988&bti=ODszNWYuMDE6&&bt=1051&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=N2kzZjQ5ODU6NjZmZTY3O0BpM3BrNm85cmRoOTMzZjczNUAvYzVfLTYtXjExYDQzMWBiYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sig…",
"https://v19-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oAOf8AMfRvsNlWGjmxzXZAYRAAH8GofifqtcQu/?a=1988&bti=ODszNWYuMDE6&&bt=1051&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=N2kzZjQ5ODU6NjZmZTY3O0BpM3BrNm85cmRoOTMzZjczNUAvYzVfLTYtXjExYDQzMWBiYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sig…"
],
"url_prefix": null,
"width": 1080
},
"quality_type": 2,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 225135}, {\\\"time\\\": 2, \\\"offset\\\": 322463}, {\\\"time\\\": 3, \\\"offset\\\": 447396}, {\\\"time\\\": 4, \\\"offset\\\": 582067}, {\\\"time\\\": 5, \\\"offset\\\": 661645}, {\\\"time\\\": 10, \\\"offset\\\": 1715217}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 95.156, \\\"v960\\\": 96.221, \\\"v864\\\": 96.904, \\\"v720\\\": 98.059}, \\\"ori\\\": {\\\"v1080\\\": 91.487, \\\"v960\\\": 92.626, \\\"v864\\\": 93.773…"
},
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 1018301,
"dub_infos": null,
"fps": 30,
"gear_name": "normal_540_0",
"is_bytevc1": 0,
"play_addr": {
"data_size": 7853651,
"file_cs": "c:0-51669-665c",
"file_hash": "ad42f752f9a96b6f47b6a73c58c4e212",
"height": 1024,
"uri": "v26044gc0000d6ve6avog65ln38hrmd0",
"url_key": "v26044gc0000d6ve6avog65ln38hrmd0_h264_540p_1018301",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/ocIdRY6ec2ZgRsRGX4fm4ALZoezG0tANA3WseG/?a=1988&bti=ODszNWYuMDE6&&bt=994&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZDc0aTQzZzc1Nzs7MzxoN0BpM3BrNm85cmRoOTMzZjczNUAxLV4tNjEuNTIxNTYzNDVfYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sign…",
"https://v19-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/ocIdRY6ec2ZgRsRGX4fm4ALZoezG0tANA3WseG/?a=1988&bti=ODszNWYuMDE6&&bt=994&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZDc0aTQzZzc1Nzs7MzxoN0BpM3BrNm85cmRoOTMzZjczNUAxLV4tNjEuNTIxNTYzNDVfYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sign…"
],
"url_prefix": null,
"width": 576
},
"quality_type": 20,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 200736}, {\\\"time\\\": 2, \\\"offset\\\": 301126}, {\\\"time\\\": 3, \\\"offset\\\": 386059}, {\\\"time\\\": 4, \\\"offset\\\": 555292}, {\\\"time\\\": 5, \\\"offset\\\": 644647}, {\\\"time\\\": 10, \\\"offset\\\": 1598115}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 91.692, \\\"v960\\\": 93.942, \\\"v864\\\": 95.111, \\\"v720\\\": 96.338}, \\\"ori\\\": {\\\"v1080\\\": 82.548, \\\"v960\\\": 85.409, \\\"v864\\\": 87.862…"
}
],
"cover": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-p-0037-euttp/oEpKmYecrBsQuAFRrD7Qa0mFAvEIQafFHM4DE0",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/oEpKmYecrBsQuAFRrD7Qa0mFAvEIQafFHM4DE0~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=7zPzid3aJiPXrKbtUpKpW%2FWa3vc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
],
"url_prefix": null,
"width": 720
},
"download_addr": {
"height": 1024,
"uri": "v26044gc0000d6ve6avog65ln38hrmd0",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c811-euttp/oMdDM2DoFPsrv4eoyRs0AB7EcrIQImgfQpuaHE/?a=1988&bti=ODszNWYuMDE6&&bt=1048&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=Z2QzPGQzNmg7NjVlOzY4ZUBpM3BrNm85cmRoOTMzZjczNUA2MmBeM2NfXmMxLjNfYzQuYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sig…"
],
"url_prefix": null,
"width": 576
},
"duration": 61000,
"dynamic_cover": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-p-0037-euttp/oglQmQ4XQAMmDcrsRFfaupDBlhvz0EE700IrCe",
"url_list": [
"https://p19-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/oglQmQ4XQAMmDcrsRFfaupDBlhvz0EE700IrCe~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=P3W%2BnerMBzfYS%2B41SEiyS5j6umE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
],
"url_prefix": null,
"width": 720
},
"has_watermark": true,
"height": 1024,
"origin_cover": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-p-0037-euttp/oEve0IQQErDAvmjFuVBaVp4MrZcDREBGQj0sf7",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/oEve0IQQErDAvmjFuVBaVp4MrZcDREBGQj0sf7~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=oVoJEH0QfSMGwbfCkStYc8eGMJE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
],
"url_prefix": null,
"width": 720
},
"play_addr": {
"data_size": 7853651,
"file_cs": "c:0-51669-665c",
"file_hash": "ad42f752f9a96b6f47b6a73c58c4e212",
"height": 1024,
"uri": "v26044gc0000d6ve6avog65ln38hrmd0",
"url_key": "v26044gc0000d6ve6avog65ln38hrmd0_h264_540p_1018301",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/ocIdRY6ec2ZgRsRGX4fm4ALZoezG0tANA3WseG/?a=1988&bti=ODszNWYuMDE6&&bt=994&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZDc0aTQzZzc1Nzs7MzxoN0BpM3BrNm85cmRoOTMzZjczNUAxLV4tNjEuNTIxNTYzNDVfYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sign…",
"https://v19-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/ocIdRY6ec2ZgRsRGX4fm4ALZoezG0tANA3WseG/?a=1988&bti=ODszNWYuMDE6&&bt=994&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZDc0aTQzZzc1Nzs7MzxoN0BpM3BrNm85cmRoOTMzZjczNUAxLV4tNjEuNTIxNTYzNDVfYSNhbzVrMmRzM3NhLS1kMTNzcw%3D%3D&expire=1793120993&l=20261026010851E516816401790B519570&ply_type=2&policy=2&sign…"
],
"url_prefix": null,
"width": 576
},
"ratio": "540p",
"width": 576
},
"is_eligible_for_commission": false,
"is_paid_partnership": false,
"is_ad": false,
"url": "https://www.tiktok.com/@whiskerwonders107/video/7619777492936576288",
"create_time_utc": "2026-03-21T18:28:22.000Z",
"shop_product_url": null
},
{
"added_sound_music_info": {
"author": "Cuties Zone",
"cover_large": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=2345758c&x-expires=1793120400&x-signature=6pxx%2BHEdL10o3LXTksjScSuGvVk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=5ae4f06a&x-expires=1793120400&x-signature=B1DWYikW%2F5WQdaAXxqMxH605SdM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=3913e454&x-expires=1793120400&x-signature=kBUlY8bSVekZ%2BkJWP6slF8LGfB4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"duration": 14,
"duration_high_precision": {
"audition_duration_precision": 14,
"duration_precision": 14,
"shoot_duration_precision": 14,
"video_duration_precision": 14
},
"id": "7678369448303397663",
"id_str": "7678369448303397663",
"is_commerce_music": true,
"is_original_sound": true,
"mid": "7678369448303397663",
"play_url": {
"height": 720,
"uri": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/o8BAo8fgJOeQflUqmwAFQuIZ6EIAIAFdAEAOfD/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=M3hrb2w5cjtpZDMzaTU8NEBpM3hrb2w5cjtpZDMzaTU8NEAtYi1nMmQ0czRhLS1kMTJzYSMtYi1nMmQ0czRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&VExpiration=1793034546&VSignature=zbNZI3BTCOHQgxtEVNzaFg&btag=e0007…",
"url_list": [
"https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/o8BAo8fgJOeQflUqmwAFQuIZ6EIAIAFdAEAOfD/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=M3hrb2w5cjtpZDMzaTU8NEBpM3hrb2w5cjtpZDMzaTU8NEAtYi1nMmQ0czRhLS1kMTJzYSMtYi1nMmQ0czRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&VExpiration=1793034546&VSignature=zbNZI3BTCOHQgxtEVNzaFg&btag=e0007…"
],
"url_prefix": null,
"width": 720
},
"shoot_duration": 14,
"title": "original sound"
},
"author": {
"avatar_larger": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=2345758c&x-expires=1793120400&x-signature=6pxx%2BHEdL10o3LXTksjScSuGvVk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"avatar_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=5ae4f06a&x-expires=1793120400&x-signature=B1DWYikW%2F5WQdaAXxqMxH605SdM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"avatar_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=3913e454&x-expires=1793120400&x-signature=kBUlY8bSVekZ%2BkJWP6slF8LGfB4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"avatar_uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"follower_count": 109900,
"following_count": 0,
"nickname": "Cuties Zone",
"sec_uid": "MS4wLjABAAAAYD6NYD2gZGVE0sVKeOu7XoojdYG3i8qQSnrD3YBE2Y5WLzM9GRu8Pe78iO_ixbho",
"secret": 0,
"signature": "Follow for Daily Stories.",
"uid": "7573610406218204215",
"unique_id": "c0625960so9"
},
"author_user_id": 7573610406218204000,
"aweme_id": "7678354914598341918",
"aweme_type": 0,
"content_type": "video",
"create_time": 1787756327,
"desc": "Dramatic Puppies Watergun Prank 😂 #puppies #watergun #puppiesoftiktok #pitbullpuppy #funnyvideo ",
"desc_language": "en",
"group_id": "7678354914598341918",
"is_ads": false,
"is_top": 0,
"item_comment_settings": 0,
"music": {
"author": "Cuties Zone",
"cover_large": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=2345758c&x-expires=1793120400&x-signature=6pxx%2BHEdL10o3LXTksjScSuGvVk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=5ae4f06a&x-expires=1793120400&x-signature=B1DWYikW%2F5WQdaAXxqMxH605SdM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"cover_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea",
"url_list": [
"https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/e72ae173bc468700ca034e95aed999ea~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=3913e454&x-expires=1793120400&x-signature=kBUlY8bSVekZ%2BkJWP6slF8LGfB4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
],
"url_prefix": null,
"width": 720
},
"duration": 14,
"duration_high_precision": {
"audition_duration_precision": 14,
"duration_precision": 14,
"shoot_duration_precision": 14,
"video_duration_precision": 14
},
"id": "7678369448303397663",
"id_str": "7678369448303397663",
"is_commerce_music": true,
"is_original_sound": true,
"mid": "7678369448303397663",
"play_url": {
"height": 720,
"uri": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/o8BAo8fgJOeQflUqmwAFQuIZ6EIAIAFdAEAOfD/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=M3hrb2w5cjtpZDMzaTU8NEBpM3hrb2w5cjtpZDMzaTU8NEAtYi1nMmQ0czRhLS1kMTJzYSMtYi1nMmQ0czRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&VExpiration=1793034546&VSignature=zbNZI3BTCOHQgxtEVNzaFg&btag=e0007…",
"url_list": [
"https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/o8BAo8fgJOeQflUqmwAFQuIZ6EIAIAFdAEAOfD/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThUQ4dGXq8Zmo&mime_type=audio_mpeg&rc=M3hrb2w5cjtpZDMzaTU8NEBpM3hrb2w5cjtpZDMzaTU8NEAtYi1nMmQ0czRhLS1kMTJzYSMtYi1nMmQ0czRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261026010851E516816401790B519570&VExpiration=1793034546&VSignature=zbNZI3BTCOHQgxtEVNzaFg&btag=e0007…"
],
"url_prefix": null,
"width": 720
},
"shoot_duration": 14,
"title": "original sound"
},
"share_url": "https://www.tiktok.com/@c0625960so9/video/7678354914598341918",
"statistics": {
"aweme_id": "7678354914598341918",
"collect_count": 70989,
"comment_count": 13700,
"digg_count": 821700,
"play_count": 20700000,
"repost_count": 0,
"share_count": 296000
},
"status": {
"allow_comment": true,
"allow_share": true,
"aweme_id": "7678354914598341918",
"in_reviewing": false,
"is_prohibited": false,
"private_status": 0,
"self_see": false
},
"text_extra": [
{
"end": 43,
"hashtag_name": "puppies",
"is_commerce": false,
"start": 35,
"type": 1
},
{
"end": 53,
"hashtag_name": "watergun",
"is_commerce": false,
"start": 44,
"type": 1
}
],
"video": {
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 1211618,
"dub_infos": null,
"fps": 24,
"gear_name": "normal_720_0",
"is_bytevc1": 0,
"play_addr": {
"data_size": 2282386,
"file_cs": "c:0-10757-2397",
"file_hash": "7f19fc4e8a28a292ea93f7a8c06049ba",
"height": 1280,
"uri": "v15044gf0000da7fsqvog65rrr43k8e0",
"url_key": "v15044gf0000da7fsqvog65rrr43k8e0_h264_720p_1211618",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oMeoX2YvguAmRGKdwAgotfiIgefe4ND7UymIAh/?a=1988&bti=ODszNWYuMDE6&&bt=1183&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGhnNjo7ZmZoNGk5Njk1aUBpMzs2dXU5cnRpZDMzaTczNEBgYDAxNC8yXzAxYWMyLWAxYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=4c…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oMeoX2YvguAmRGKdwAgotfiIgefe4ND7UymIAh/?a=1988&bti=ODszNWYuMDE6&&bt=1183&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGhnNjo7ZmZoNGk5Njk1aUBpMzs2dXU5cnRpZDMzaTczNEBgYDAxNC8yXzAxYWMyLWAxYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=4c…"
],
"url_prefix": null,
"width": 720
},
"quality_type": 10,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 241053}, {\\\"time\\\": 2, \\\"offset\\\": 385972}, {\\\"time\\\": 3, \\\"offset\\\": 538787}, {\\\"time\\\": 4, \\\"offset\\\": 705504}, {\\\"time\\\": 5, \\\"offset\\\": 870572}, {\\\"time\\\": 10, \\\"offset\\\": 1593021}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 89.027, \\\"v960\\\": 90.242, \\\"v864\\\": 92.336, \\\"v720\\\": 93.833}, \\\"ori\\\": {\\\"v1080\\\": 89.027, \\\"v960\\\": 90.242, \\\"v864\\\": 92.336…"
},
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 579197,
"dub_infos": null,
"fps": 24,
"gear_name": "adapt_lower_720_1",
"is_bytevc1": 1,
"play_addr": {
"data_size": 1091063,
"file_cs": "c:0-10961-a766",
"file_hash": "8da8e0eee8e3d03ff28710513f33a104",
"height": 1280,
"uri": "v15044gf0000da7fsqvog65rrr43k8e0",
"url_key": "v15044gf0000da7fsqvog65rrr43k8e0_bytevc1_720p_579197",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oQmIqEJmAA8Xi37IIifs31BAwBRMciC6jCg1Qs/?a=1988&bti=ODszNWYuMDE6&&bt=565&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=NTk0O2k2NjpkO2ZlZWk1M0BpMzs2dXU5cnRpZDMzaTczNEBfXjMzLzFgX2IxLTMxXmEyYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=daa…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oQmIqEJmAA8Xi37IIifs31BAwBRMciC6jCg1Qs/?a=1988&bti=ODszNWYuMDE6&&bt=565&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=NTk0O2k2NjpkO2ZlZWk1M0BpMzs2dXU5cnRpZDMzaTczNEBfXjMzLzFgX2IxLTMxXmEyYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=daa…"
],
"url_prefix": null,
"width": 720
},
"quality_type": 14,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 123060}, {\\\"time\\\": 2, \\\"offset\\\": 195871}, {\\\"time\\\": 3, \\\"offset\\\": 251628}, {\\\"time\\\": 4, \\\"offset\\\": 338624}, {\\\"time\\\": 5, \\\"offset\\\": 404549}, {\\\"time\\\": 10, \\\"offset\\\": 758402}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 95.531, \\\"v960\\\": 96.542, \\\"v864\\\": 97.586, \\\"v720\\\": 98.692}, \\\"ori\\\": {\\\"v1080\\\": 86.265, \\\"v960\\\": 89.111, \\\"v864\\\": 90.828,…"
}
],
"cover": {
"data_size": 0,
"height": 720,
"uri": "tos-useast8-p-0068-tx2/oYAAhtEQIEAqrEjfZfFVdOEW6m56IEAwDCvRA3",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oYAAhtEQIEAqrEjfZfFVdOEW6m56IEAwDCvRA3~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=44TiITbRBIXSKyg9x8zfQHq1pUE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
],
"url_prefix": null,
"width": 720
},
"download_addr": {
"height": 1280,
"uri": "v15044gf0000da7fsqvog65rrr43k8e0",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oAd43FBRVDq8jBE5fADZA4z0QfQrvDEEAcIyvg/?a=1988&bti=ODszNWYuMDE6&&bt=1031&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=aTk7MzYzNWg8ZjYzZ2g1NkBpMzs2dXU5cnRpZDMzaTczNEBiNC8xMjE0NjIxNF8xLzAvYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=7b…"
],
"url_prefix": null,
"width": 720
},
"duration": 15000,
"dynamic_cover": {
"data_size": 0,
"height": 720,
"uri": "tos-useast8-p-0068-tx2/oYAAhtEQIEAqrEjfZfFVdOEW6m56IEAwDCvRA3",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oYAAhtEQIEAqrEjfZfFVdOEW6m56IEAwDCvRA3~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=44TiITbRBIXSKyg9x8zfQHq1pUE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
],
"url_prefix": null,
"width": 720
},
"has_watermark": true,
"height": 1280,
"origin_cover": {
"data_size": 0,
"height": 720,
"uri": "tos-useast8-p-0068-tx2/ooyE4fvd0ApRD2ZQCB3EArBVfEjFQQ0ZqQ5vKM",
"url_list": [
"https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ooyE4fvd0ApRD2ZQCB3EArBVfEjFQQ0ZqQ5vKM~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=8ZwKC0yB2vEOeWxUxB9792ExIC4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my"
],
"url_prefix": null,
"width": 720
},
"play_addr": {
"data_size": 2282386,
"file_cs": "c:0-10757-2397",
"file_hash": "7f19fc4e8a28a292ea93f7a8c06049ba",
"height": 1280,
"uri": "v15044gf0000da7fsqvog65rrr43k8e0",
"url_key": "v15044gf0000da7fsqvog65rrr43k8e0_h264_720p_1211618",
"url_list": [
"https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oMeoX2YvguAmRGKdwAgotfiIgefe4ND7UymIAh/?a=1988&bti=ODszNWYuMDE6&&bt=1183&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGhnNjo7ZmZoNGk5Njk1aUBpMzs2dXU5cnRpZDMzaTczNEBgYDAxNC8yXzAxYWMyLWAxYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=4c…",
"https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oMeoX2YvguAmRGKdwAgotfiIgefe4ND7UymIAh/?a=1988&bti=ODszNWYuMDE6&&bt=1183&ft=-Csk_mXMPD12NplyLn-UxIX2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGhnNjo7ZmZoNGk5Njk1aUBpMzs2dXU5cnRpZDMzaTczNEBgYDAxNC8yXzAxYWMyLWAxYSNiaDFvMmRzcDRhLS1kMTJzcw%3D%3D&expire=1793120947&l=20261026010851E516816401790B519570&ply_type=2&policy=2&signature=4c…"
],
"url_prefix": null,
"width": 720
},
"ratio": "720p",
"width": 720
},
"is_eligible_for_commission": false,
"is_paid_partnership": false,
"is_ad": false,
"url": "https://www.tiktok.com/@c0625960so9/video/7678354914598341918",
"create_time_utc": "2026-08-26T14:58:47.000Z",
"shop_product_url": null
}
]
}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`. To page, send the response's `cursor` back as `cursor` (20, 40, ...) while `has_more` is 1. The selection of videos changes over time. An unknown hashtag, or a page with no videos, is an empty list for 0 credits. The video objects do not include `region`.
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.