TIKTOK API
Search by Hashtag
Retrieve search by hashtag from TikTok with a single API request.
GET
/api/data/v1/tiktok/search/hashtag1credit base cost
Request parameters
Up to 1 creditHashtag to search for (without #)
Region the proxy will be set to. Note: this isn't going to grab you all tiktoks from this region, you're just setting the proxy there.
Cursor to get more videos. Get 'cursor' from previous response.
Set to true to get a trimmed response
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/tiktok/search/hashtag' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"aweme_list": [
{
"aweme_id": "7277923990184742177",
"desc": "best boys #friends #joeytribbiani #chandlerbing #joeyandchandler #sitcom #mecore #uscore #bromance #matthewperry #mattleblanc ",
"desc_language": "en",
"region": "DE",
"statistics": {
"aweme_id": "7277923990184742177",
"collect_count": 385471,
"comment_count": 94635,
"digg_count": 2840077,
"download_count": 1318,
"forward_count": 0,
"lose_comment_count": 0,
"lose_count": 0,
"play_count": 12711728,
"repost_count": 0,
"share_count": 614428,
"whatsapp_share_count": 19390
},
"video": {
"CoverTsp": 7.68255116568915,
"ai_dynamic_cover": {
"uri": "tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739",
"url_list": [
"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"
],
"url_prefix": null
},
"ai_dynamic_cover_bak": {
"uri": "tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739",
"url_list": [
"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"
],
"url_prefix": null
},
"animated_cover": {
"uri": "tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739",
"url_list": [
"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"
],
"url_prefix": null
},
"big_thumbs": [],
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 364924,
"dub_infos": null,
"fid_profile_labels": "",
"fps": 30,
"gear_name": "adapt_540_1",
"is_bytevc1": 1,
"play_addr": {
"data_size": 759407,
"file_cs": "c:0-15397-6132",
"file_hash": "f44716c0f1de35c8618470f551dde04b",
"height": 576,
"uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
"url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_bytevc1_540p_364924",
"url_list": [
"https://v45.tiktokcdn-eu.com/339e98fc0becce4e1728c5ef64d69b69/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=712&bt=356&cs=2&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=11&rc=OmRkODVmaDQzMzpmZDM2NUBpajpybmY6Zmk5bjMzZjczM0BjNGE0YmExNi8xYi8wLmNgYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"
],
"url_prefix": null,
"width": 576
},
"quality_type": 28,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 105212}, {\\\"time\\\": 2, \\\"offset\\\": 155336}, {\\\"time\\\": 3, \\\"offset\\\": 188263}, {\\\"time\\\": 4, \\\"offset\\\": 240132}, {\\\"time\\\": 5, \\\"offset\\\": 297488}, {\\\"time\\\": 10, \\\"offset\\\": 500467}]\",\"mvmaf\":\"\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"9a60c2c4c41021710925f796744dd9e0\",\"dec_info\":\"\",\"gearvqm\":\"\"}"
}
],
"bit_rate_audio": [],
"cdn_url_expired": 0,
"cla_info": {
"caption_infos": null,
"captions_type": 0,
"creator_edited_caption_id": 0,
"enable_auto_caption": 0,
"has_original_audio": 0,
"hide_original_caption": false,
"no_caption_reason": 3,
"vertical_positions": null
},
"cover": {
"height": 720,
"uri": "tos-useast2a-p-0037-euttp/7eb5601a4f4b4134b8321955a5ceb515_1694523738",
"url_list": [
"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/7eb5601a4f4b4134b8321955a5ceb515_1694523738~tplv-tiktokx-origin.image?dr=1347&refresh_token=04c0a26b&x-expires=1750377600&x-signature=D80fHwx2YQmu%2Bs7fKVs6JvfrDwo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&sc=cover&biz_tag=tt_video&s=CHALLENGE_AWEME"
],
"url_prefix": null,
"width": 720
},
"cover_is_custom": true,
"did_profile_labels": "",
"download_addr": {
"data_size": 1645666,
"file_cs": "c:0-15212-b6fb",
"height": 720,
"uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
"url_list": [
"https://v45.tiktokcdn-eu.com/de0e8da0f33c14a280afb63dbbd7200f/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/oYBtGfE0AWGREzMHElYDeRkucMhEAlDPQQBAIR/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1544&bt=772&cs=0&ds=3&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=aWRoOmY3NDg5N2hlZzM7NUBpajpybmY6Zmk5bjMzZjczM0BhMDQvXjQtNWExNDYzLzReYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"
],
"url_prefix": null,
"width": 720
},
"download_no_watermark_addr": {
"data_size": 1596498,
"file_cs": "c:0-15212-b6fb",
"file_hash": "865acc2a4a685aa6fe71256e1f7c8510",
"height": 576,
"uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
"url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178",
"url_list": [
"https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1498&bt=749&cs=0&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NDQ0ZDs3OWVpPGhkO2Q4aEBpajpybmY6Zmk5bjMzZjczM0A0YjJfLWBiNS0xXjNjYGIvYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"
],
"url_prefix": null,
"width": 576
},
"duration": 16648,
"dynamic_cover": {
"height": 720,
"uri": "tos-useast2a-p-0037-euttp/d1dfbab565b84a92ad94eca69e455a4c_1694523739",
"url_list": [
"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/d1dfbab565b84a92ad94eca69e455a4c_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=508a3268&x-expires=1750377600&x-signature=KsNxQZIhu4mTRZLEkpl%2FgG0WJVE%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"
],
"url_prefix": null,
"width": 720
},
"has_watermark": true,
"height": 576,
"is_bytevc1": 0,
"is_callback": true,
"meta": "{\"LoudnessRange\":\"0.7\",\"LoudnessRangeEnd\":\"-9.5\",\"LoudnessRangeStart\":\"-10.2\",\"MaximumMomentaryLoudness\":\"-7.7\",\"MaximumShortTermLoudness\":\"-9.4\",\"Version\":\"1\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-10.2,\\\"Version\\\":1,\\\"LoudnessRangeEnd\\\":-9.5,\\\"LoudnessRange\\\":0.7,\\\"Peak\\\":1,\\\"Loudness\\\":-10,\\\"MaximumMomentaryLoudness\\\":-7.7,\\\"MaximumShortTermLoudness\\\":-9.4}\",\"flight_id\":\"\",\"loudness\":\"-10\",\"peak\":\"1\",\"play_time_prob_dist\":\"[800,0.801,3121.2698]\",\"sr_score\":\"1.000\",\"vq_score\":\"55.37\"}",
"misc_download_addrs": "{\"suffix_scene\":{\"uri\":\"v0f044gc0000ck062fbc77uc8kdoc7ig\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/4f9aadaa474b036d50f519f6afd2bd4d/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0EAztMeEhDPExJHRQlQfBRRIKRGAoGlFDFBuz/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1288&bt=644&cs=0&ds=3&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NzY5Mzc7ZTpkN2llOWQ6NkBpajpybmY6Zmk5bjMzZjczM0A1YTRgNTNfNl8xX15fL2E2YSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000\",\"https://v16m.tiktokcdn-eu.com/68473afcbc37657465779bf3399bc190/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001",
"need_set_token": false,
"origin_cover": {
"height": 720,
"uri": "tos-useast2a-p-0037-euttp/8645744258524a9eb63d68fac73a3fd2_1694523738",
"url_list": [
"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/8645744258524a9eb63d68fac73a3fd2_1694523738~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=262a17a9&x-expires=1750377600&x-signature=1EZLLyR6gut1idQPWSTz6KJLaWk%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=c0f880ed&idc=no1a&s=CHALLENGE_AWEME&sc=feed_cover&biz_tag=tt_video"
],
"url_prefix": null,
"width": 720
},
"play_addr": {
"data_size": 1596498,
"file_cs": "c:0-15212-b6fb",
"file_hash": "865acc2a4a685aa6fe71256e1f7c8510",
"height": 576,
"uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
"url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178",
"url_list": [
"https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1498&bt=749&cs=0&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NDQ0ZDs3OWVpPGhkO2Q4aEBpajpybmY6Zmk5bjMzZjczM0A0YjJfLWBiNS0xXjNjYGIvYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"
],
"url_prefix": null,
"width": 576
},
"play_addr_bytevc1": {
"data_size": 759407,
"file_cs": "c:0-15397-6132",
"file_hash": "f44716c0f1de35c8618470f551dde04b",
"height": 576,
"uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
"url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_bytevc1_540p_364924",
"url_list": [
"https://v45.tiktokcdn-eu.com/339e98fc0becce4e1728c5ef64d69b69/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=712&bt=356&cs=2&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=11&rc=OmRkODVmaDQzMzpmZDM2NUBpajpybmY6Zmk5bjMzZjczM0BjNGE0YmExNi8xYi8wLmNgYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"
],
"url_prefix": null,
"width": 576
},
"play_addr_h264": {
"data_size": 1596498,
"file_cs": "c:0-15212-b6fb",
"file_hash": "865acc2a4a685aa6fe71256e1f7c8510",
"height": 576,
"uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
"url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178",
"url_list": [
"https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1498&bt=749&cs=0&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NDQ0ZDs3OWVpPGhkO2Q4aEBpajpybmY6Zmk5bjMzZjczM0A0YjJfLWBiNS0xXjNjYGIvYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"
],
"url_prefix": null,
"width": 576
},
"ratio": "540p",
"source_HDR_type": 0,
"tags": null,
"vid_profile_labels": "{\"tier3\":\"10045\"}",
"width": 576
},
"author": {
"accept_private_policy": false,
"account_labels": null,
"account_region": "",
"ad_cover_url": null,
"advance_feature_item_order": null,
"advanced_feature_info": null,
"apple_account": 0,
"authority_status": 0,
"avatar_168x168": {
"height": 720,
"uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
"url_list": [
"https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_300x300": {
"height": 720,
"uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
"url_list": [
"https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_larger": {
"height": 720,
"uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
"url_list": [
"https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_medium": {
"height": 720,
"uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
"url_list": [
"https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
"url_list": [
"https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
"aweme_count": 0,
"bind_phone": "",
"bold_fields": null,
"can_message_follow_status_list": [
2
],
"can_set_geofencing": null,
"cha_list": null,
"comment_filter_status": 0,
"comment_setting": 0,
"commerce_user_level": 0,
"cover_url": [],
"create_time": 0,
"custom_verify": "",
"cv_level": "",
"download_prompt_ts": 0,
"download_setting": 0,
"duet_setting": 0,
"enabled_filter_all_comments": false,
"enterprise_verify_reason": "",
"events": null,
"fake_data_info": {},
"favoriting_count": 0,
"fb_expire_time": 0,
"follow_status": 0,
"follower_count": 0,
"follower_status": 0,
"followers_detail": null,
"following_count": 0,
"friends_status": 0,
"gender": 0,
"geofencing": null,
"google_account": "",
"has_email": false,
"has_facebook_token": false,
"has_insights": false,
"has_orders": false,
"has_twitter_token": false,
"has_youtube_token": false,
"hide_search": false,
"homepage_bottom_toast": null,
"ins_id": "",
"is_ad_fake": false,
"is_block": false,
"is_discipline_member": false,
"is_mute": 0,
"is_mute_lives": 0,
"is_mute_non_story_post": 0,
"is_mute_story": 0,
"is_phone_binded": false,
"is_star": false,
"item_list": null,
"language": "de",
"live_agreement": 0,
"live_commerce": false,
"live_verify": 0,
"mention_status": 1,
"mutual_relation_avatars": null,
"need_points": null,
"need_recommend": 0,
"nickname": "<3",
"platform_sync_info": null,
"prevent_download": false,
"react_setting": 0,
"region": "DE",
"relative_users": null,
"reply_with_video_flag": 4,
"room_id": 0,
"search_highlight": null,
"sec_uid": "MS4wLjABAAAAEGw8JuhdX33fLjsNSbP9jyukCEyrVGvk3tnT_UECChlvrnYSjfUve-xEgbN106ES",
"secret": 0,
"share_info": {
"now_invitation_card_image_urls": null,
"share_desc": "",
"share_desc_info": "",
"share_qrcode_url": {
"height": 720,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 720
},
"share_title": "",
"share_title_myself": "",
"share_title_other": "",
"share_url": ""
},
"share_qrcode_uri": "",
"shield_comment_notice": 0,
"shield_digg_notice": 0,
"shield_edit_field_info": null,
"shield_follow_notice": 0,
"short_id": "0",
"show_image_bubble": false,
"signature": "💐🦢🌷🍃🧸\nshe/her; virgo; infj *:･ﾟ\nyou are all loved<3\n— don’t spam like!",
"special_account": {
"special_account_list": null
},
"special_lock": 1,
"status": 1,
"stitch_setting": 0,
"total_favorited": 0,
"tw_expire_time": 0,
"twitter_id": "",
"twitter_name": "",
"type_label": null,
"uid": "7139438496381240326",
"unique_id": "gilmoreluvrr",
"unique_id_modify_time": 1750292306,
"user_canceled": false,
"user_mode": 1,
"user_now_pack_info": {},
"user_period": 0,
"user_profile_guide": null,
"user_rate": 1,
"user_spark_info": {},
"user_tags": null,
"verification_type": 1,
"verify_info": "",
"video_icon": {
"height": 720,
"uri": "",
"url_list": [],
"url_prefix": null,
"width": 720
},
"white_cover_url": null,
"with_commerce_entry": false,
"with_shop_entry": false,
"youtube_channel_id": "",
"youtube_channel_title": "",
"youtube_expire_time": 0
},
"is_eligible_for_commission": true,
"is_paid_partnership": false,
"create_time_utc": "2025-09-03T18:37:38.000Z",
"url": "https://www.tiktok.com/@branttakes/video/7545933721589910798",
"shop_product_url": "https://www.tiktok.com/shop/pdp/1729494515984797858"
}
],
"cursor": 20,
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"aweme_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aweme_id": {
"type": "string"
},
"desc": {
"type": "string"
},
"desc_language": {
"type": "string"
},
"region": {
"type": "string"
},
"statistics": {
"type": "object",
"properties": {
"aweme_id": {
"type": "string"
},
"collect_count": {
"type": "integer"
},
"comment_count": {
"type": "integer"
},
"digg_count": {
"type": "integer"
},
"download_count": {
"type": "integer"
},
"forward_count": {
"type": "integer"
},
"lose_comment_count": {
"type": "integer"
},
"lose_count": {
"type": "integer"
},
"play_count": {
"type": "integer"
},
"repost_count": {
"type": "integer"
},
"share_count": {
"type": "integer"
},
"whatsapp_share_count": {
"type": "integer"
}
}
},
"video": {
"type": "object",
"properties": {
"CoverTsp": {
"type": "number"
},
"ai_dynamic_cover": {
"type": "object",
"properties": {
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"ai_dynamic_cover_bak": {
"type": "object",
"properties": {
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"animated_cover": {
"type": "object",
"properties": {
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"big_thumbs": {
"type": "array"
},
"bit_rate": {
"type": "array",
"items": {
"type": "object",
"properties": {
"HDR_bit": {
"type": "string"
},
"HDR_type": {
"type": "string"
},
"bit_rate": {
"type": "integer"
},
"dub_infos": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"fid_profile_labels": {
"type": "string"
},
"fps": {
"type": "integer"
},
"gear_name": {
"type": "string"
},
"is_bytevc1": {
"type": "integer"
},
"play_addr": {
"type": "object",
"properties": {
"data_size": {
"type": "integer"
},
"file_cs": {
"type": "string"
},
"file_hash": {
"type": "string"
},
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_key": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"quality_type": {
"type": "integer"
},
"video_extra": {
"type": "string"
}
}
}
},
"bit_rate_audio": {
"type": "array"
},
"cdn_url_expired": {
"type": "integer"
},
"cla_info": {
"type": "object",
"properties": {
"caption_infos": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"captions_type": {
"type": "integer"
},
"creator_edited_caption_id": {
"type": "integer"
},
"enable_auto_caption": {
"type": "integer"
},
"has_original_audio": {
"type": "integer"
},
"hide_original_caption": {
"type": "boolean"
},
"no_caption_reason": {
"type": "integer"
},
"vertical_positions": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"cover": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"cover_is_custom": {
"type": "boolean"
},
"did_profile_labels": {
"type": "string"
},
"download_addr": {
"type": "object",
"properties": {
"data_size": {
"type": "integer"
},
"file_cs": {
"type": "string"
},
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"download_no_watermark_addr": {
"type": "object",
"properties": {
"data_size": {
"type": "integer"
},
"file_cs": {
"type": "string"
},
"file_hash": {
"type": "string"
},
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_key": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"duration": {
"type": "integer"
},
"dynamic_cover": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"has_watermark": {
"type": "boolean"
},
"height": {
"type": "integer"
},
"is_bytevc1": {
"type": "integer"
},
"is_callback": {
"type": "boolean"
},
"meta": {
"type": "string"
},
"misc_download_addrs": {
"type": "string"
},
"need_set_token": {
"type": "boolean"
},
"origin_cover": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"play_addr": {
"type": "object",
"properties": {
"data_size": {
"type": "integer"
},
"file_cs": {
"type": "string"
},
"file_hash": {
"type": "string"
},
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_key": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"play_addr_bytevc1": {
"type": "object",
"properties": {
"data_size": {
"type": "integer"
},
"file_cs": {
"type": "string"
},
"file_hash": {
"type": "string"
},
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_key": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"play_addr_h264": {
"type": "object",
"properties": {
"data_size": {
"type": "integer"
},
"file_cs": {
"type": "string"
},
"file_hash": {
"type": "string"
},
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_key": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"ratio": {
"type": "string"
},
"source_HDR_type": {
"type": "integer"
},
"tags": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"vid_profile_labels": {
"type": "string"
},
"width": {
"type": "integer"
}
}
},
"author": {
"type": "object",
"properties": {
"accept_private_policy": {
"type": "boolean"
},
"account_labels": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"account_region": {
"type": "string"
},
"ad_cover_url": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"advance_feature_item_order": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"advanced_feature_info": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"apple_account": {
"type": "integer"
},
"authority_status": {
"type": "integer"
},
"avatar_168x168": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"avatar_300x300": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"avatar_larger": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"avatar_medium": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"avatar_thumb": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"avatar_uri": {
"type": "string"
},
"aweme_count": {
"type": "integer"
},
"bind_phone": {
"type": "string"
},
"bold_fields": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"can_message_follow_status_list": {
"type": "array",
"items": {
"type": "integer"
}
},
"can_set_geofencing": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"cha_list": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"comment_filter_status": {
"type": "integer"
},
"comment_setting": {
"type": "integer"
},
"commerce_user_level": {
"type": "integer"
},
"cover_url": {
"type": "array"
},
"create_time": {
"type": "integer"
},
"custom_verify": {
"type": "string"
},
"cv_level": {
"type": "string"
},
"download_prompt_ts": {
"type": "integer"
},
"download_setting": {
"type": "integer"
},
"duet_setting": {
"type": "integer"
},
"enabled_filter_all_comments": {
"type": "boolean"
},
"enterprise_verify_reason": {
"type": "string"
},
"events": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"fake_data_info": {
"type": "object",
"properties": {}
},
"favoriting_count": {
"type": "integer"
},
"fb_expire_time": {
"type": "integer"
},
"follow_status": {
"type": "integer"
},
"follower_count": {
"type": "integer"
},
"follower_status": {
"type": "integer"
},
"followers_detail": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"following_count": {
"type": "integer"
},
"friends_status": {
"type": "integer"
},
"gender": {
"type": "integer"
},
"geofencing": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"google_account": {
"type": "string"
},
"has_email": {
"type": "boolean"
},
"has_facebook_token": {
"type": "boolean"
},
"has_insights": {
"type": "boolean"
},
"has_orders": {
"type": "boolean"
},
"has_twitter_token": {
"type": "boolean"
},
"has_youtube_token": {
"type": "boolean"
},
"hide_search": {
"type": "boolean"
},
"homepage_bottom_toast": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"ins_id": {
"type": "string"
},
"is_ad_fake": {
"type": "boolean"
},
"is_block": {
"type": "boolean"
},
"is_discipline_member": {
"type": "boolean"
},
"is_mute": {
"type": "integer"
},
"is_mute_lives": {
"type": "integer"
},
"is_mute_non_story_post": {
"type": "integer"
},
"is_mute_story": {
"type": "integer"
},
"is_phone_binded": {
"type": "boolean"
},
"is_star": {
"type": "boolean"
},
"item_list": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"language": {
"type": "string"
},
"live_agreement": {
"type": "integer"
},
"live_commerce": {
"type": "boolean"
},
"live_verify": {
"type": "integer"
},
"mention_status": {
"type": "integer"
},
"mutual_relation_avatars": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"need_points": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"need_recommend": {
"type": "integer"
},
"nickname": {
"type": "string"
},
"platform_sync_info": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"prevent_download": {
"type": "boolean"
},
"react_setting": {
"type": "integer"
},
"region": {
"type": "string"
},
"relative_users": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"reply_with_video_flag": {
"type": "integer"
},
"room_id": {
"type": "integer"
},
"search_highlight": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"sec_uid": {
"type": "string"
},
"secret": {
"type": "integer"
},
"share_info": {
"type": "object",
"properties": {
"now_invitation_card_image_urls": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"share_desc": {
"type": "string"
},
"share_desc_info": {
"type": "string"
},
"share_qrcode_url": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array"
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"share_title": {
"type": "string"
},
"share_title_myself": {
"type": "string"
},
"share_title_other": {
"type": "string"
},
"share_url": {
"type": "string"
}
}
},
"share_qrcode_uri": {
"type": "string"
},
"shield_comment_notice": {
"type": "integer"
},
"shield_digg_notice": {
"type": "integer"
},
"shield_edit_field_info": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"shield_follow_notice": {
"type": "integer"
},
"short_id": {
"type": "string"
},
"show_image_bubble": {
"type": "boolean"
},
"signature": {
"type": "string"
},
"special_account": {
"type": "object",
"properties": {
"special_account_list": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"special_lock": {
"type": "integer"
},
"status": {
"type": "integer"
},
"stitch_setting": {
"type": "integer"
},
"total_favorited": {
"type": "integer"
},
"tw_expire_time": {
"type": "integer"
},
"twitter_id": {
"type": "string"
},
"twitter_name": {
"type": "string"
},
"type_label": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"uid": {
"type": "string"
},
"unique_id": {
"type": "string"
},
"unique_id_modify_time": {
"type": "integer"
},
"user_canceled": {
"type": "boolean"
},
"user_mode": {
"type": "integer"
},
"user_now_pack_info": {
"type": "object",
"properties": {}
},
"user_period": {
"type": "integer"
},
"user_profile_guide": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"user_rate": {
"type": "integer"
},
"user_spark_info": {
"type": "object",
"properties": {}
},
"user_tags": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"verification_type": {
"type": "integer"
},
"verify_info": {
"type": "string"
},
"video_icon": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array"
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"white_cover_url": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"with_commerce_entry": {
"type": "boolean"
},
"with_shop_entry": {
"type": "boolean"
},
"youtube_channel_id": {
"type": "string"
},
"youtube_channel_title": {
"type": "string"
},
"youtube_expire_time": {
"type": "integer"
}
}
},
"is_eligible_for_commission": {
"type": "boolean"
},
"is_paid_partnership": {
"type": "boolean"
},
"create_time_utc": {
"type": "string"
},
"url": {
"type": "string"
},
"shop_product_url": {
"type": "string"
}
}
}
},
"cursor": {
"type": "integer"
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}