TIKTOK API
Video Info
Retrieve video info from TikTok with a single API request.
GET
/api/data/v2/tiktok/video1credit base costZero-credit cache supported
Request parameters
Up to 1 creditTikTok video URL
Get transcript of the video
Region of the proxy. Sometimes you'll need to specify the region if you're not getting a response. Commonly for videos from the Phillipines, in which case you'd use 'PH'. Use 2 letter country codes like US, GB, FR, etc
Set to true to get a trimmed response
Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.
If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.]
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40randomspamvideos25%2Fvideo%2F7251387037834595630' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"aweme_detail": {
"aweme_id": "7517114944362499342",
"desc": "You can say whatever you want about the WNBA is but it’s never boring",
"desc_language": "en",
"region": "US",
"statistics": {
"aweme_id": "7517114944362499342",
"collect_count": 1633,
"comment_count": 618,
"digg_count": 62522,
"download_count": 190,
"forward_count": 0,
"lose_comment_count": 0,
"lose_count": 0,
"play_count": 589745,
"repost_count": 0,
"share_count": 3585,
"whatsapp_share_count": 8
},
"video": {
"CoverTsp": 140.193500922967,
"ai_dynamic_cover": {
"uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"
],
"url_prefix": null
},
"ai_dynamic_cover_bak": {
"uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"
],
"url_prefix": null
},
"animated_cover": {
"uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"
],
"url_prefix": null
},
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 694328,
"dub_infos": null,
"fid_profile_labels": "",
"fps": 30,
"gear_name": "adapt_lower_720_2",
"is_bytevc1": 2,
"play_addr": {
"data_size": 15073438,
"file_cs": "c:0-144831-d8fd",
"file_hash": "bade4c49b717e85095bf288836f2cf41",
"height": 1280,
"uri": "v12044gd0000d192fcnog65ouluk5f60",
"url_key": "v12044gd0000d192fcnog65ouluk5f60_bytevc2_720p_694328",
"url_list": [
"https://v45.tiktokcdn-eu.com/181058a705ab5b81ac71c7ec81b7d91c/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oQOIKCXpeQMxlHgA9YwA8fQqQkIfj3UHkctEaC/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1356&bt=678&cs=5&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=14&rc=ZWQ3OTk1ODMzZGU0NjY3aUBpM2lub3I5cmY1NDMzZzczNEAuNS8yMl4tX18xNmAuYzUwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"
],
"url_prefix": null,
"width": 720
},
"quality_type": 14,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 264024}, {\\\"time\\\": 2, \\\"offset\\\": 330253}, {\\\"time\\\": 3, \\\"offset\\\": 403843}, {\\\"time\\\": 4, \\\"offset\\\": 488694}, {\\\"time\\\": 5, \\\"offset\\\": 579736}, {\\\"time\\\": 10, \\\"offset\\\": 996199}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 96.728, \\\"v960\\\": 97.931, \\\"v864\\\": 98.683, \\\"v720\\\": 99.11}, \\\"ori\\\": {\\\"v1080\\\": 89.806, \\\"v960\\\": 91.917, \\\"v864\\\": 92.924, \\\"v720\\\": 95.104}}}\",\"ufq\":\"{\\\"enh\\\":66.187,\\\"playback\\\":{\\\"ori\\\":59.993,\\\"srv1\\\":64.978},\\\"src\\\":66.187,\\\"trans\\\":59.993,\\\"version\\\":\\\"v1.2\\\"}\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"398b00a3a79e904ef5421940da02ff2a\",\"dec_info\":\"\",\"gearvqm\":\"\"}"
}
],
"bit_rate_audio": [],
"cdn_url_expired": 0,
"cover": {
"height": 720,
"uri": "tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI~tplv-tiktokx-cropcenter-q:300:400:q72.heic?dr=9232&refresh_token=df2ee5c4&x-expires=1750374000&x-signature=F1wskCOFUKVbHMDT%2BjC%2F4ioi3Vw%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&sc=cover&biz_tag=tt_video&s=AWEME_DETAIL"
],
"url_prefix": null,
"width": 720
},
"cover_is_custom": true,
"did_profile_labels": "",
"download_addr": {
"data_size": 24637995,
"file_cs": "c:0-143697-b9bb",
"height": 720,
"uri": "v12044gd0000d192fcnog65ouluk5f60",
"url_list": [
"https://v45.tiktokcdn-eu.com/3d049ec218f82d1ad3e7e9ee12cccb39/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/osMffQHg9IKplXhIekq8xUpGsKuYCjAqSQQEAH/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2216&bt=1108&cs=0&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=NDxmZGg1ZTw6NGlkNDM1N0BpM2lub3I5cmY1NDMzZzczNEAuMGEwMGBfXmExMWA2Y2I2YSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"
],
"url_prefix": null,
"width": 720
},
"download_no_watermark_addr": {
"data_size": 23315651,
"file_cs": "c:0-143697-b9bb",
"file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
"height": 1024,
"uri": "v12044gd0000d192fcnog65ouluk5f60",
"url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
"url_list": [
"https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"
],
"url_prefix": null,
"width": 576
},
"duration": 173675,
"dynamic_cover": {
"height": 720,
"uri": "tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F~tplv-tiktokx-origin.image?dr=9229&refresh_token=949e4dcb&x-expires=1750374000&x-signature=nMjefiiuLg8GZ9QABQL3YDVaKHo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"
],
"url_prefix": null,
"width": 720
},
"has_watermark": true,
"height": 1024,
"is_bytevc1": 0,
"is_callback": true,
"is_long_video": 1,
"meta": "{\"LoudnessRange\":\"4.2\",\"LoudnessRangeEnd\":\"-15.5\",\"LoudnessRangeStart\":\"-19.7\",\"MaximumMomentaryLoudness\":\"-9.6\",\"MaximumShortTermLoudness\":\"-14\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-19.7,\\\"MaximumShortTermLoudness\\\":-14,\\\"Peak\\\":1,\\\"Metrics\\\":{\\\"AEDInfo\\\":{\\\"MusicRatio\\\":0,\\\"SingingRatio\\\":0.1,\\\"SpeechRatio\\\":0.89},\\\"AnchorLoudness\\\":{\\\"Speech\\\":{\\\"MaxMomLoud\\\":-9.61,\\\"MaxSTLoud\\\":-14.04,\\\"Loud\\\":-16.88,\\\"LoudR\\\":4,\\\"LoudRE\\\":-15.3,\\\"LoudRS\\\":-19.3}},\\\"Cutoff\\\":{\\\"FCenL\\\":2028.05,\\\"FCenR\\\":2888.08,\\\"Spkr100G\\\":0,\\\"Spkr150G\\\":0.07,\\\"Spkr200G\\\":0.28},\\\"Loudness\\\":{\\\"Integrated\\\":-16.956},\\\"Phase\\\":{\\\"RMSDownmixDiff\\\":-0.635},\\\"RMSStats\\\":{\\\"Peak\\\":0.099,\\\"RTotal\\\":-25.112,",
"misc_download_addrs": "{\"suffix_scene\":{\"uri\":\"v12044gd0000d192fcnog65ouluk5f60\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/eb4b1ebe709b6ec8bb4b8e40c7c1d919/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2304&bt=1152&cs=0&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=PDQ8MzRkOjc7OzdkNzo6aUBpM2lub3I5cmY1NDMzZzczNEAuX2NeXzMyNjUxNjBeLmEwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000\",\"https://v16m.tiktokcdn-eu.com/cf3dc5bd920320de7fccd7a67e8ff0df/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISH",
"need_set_token": false,
"origin_cover": {
"height": 720,
"uri": "tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI",
"url_list": [
"https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=4649c5e4&x-expires=1750374000&x-signature=NcVGrk0KTmDoN6EaPa%2Fn05CEyq4%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&s=AWEME_DETAIL&sc=feed_cover&biz_tag=tt_video"
],
"url_prefix": null,
"width": 720
},
"play_addr": {
"data_size": 23315651,
"file_cs": "c:0-143697-b9bb",
"file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
"height": 1024,
"uri": "v12044gd0000d192fcnog65ouluk5f60",
"url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
"url_list": [
"https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"
],
"url_prefix": null,
"width": 576
},
"play_addr_bytevc1": {
"data_size": 13687862,
"file_cs": "c:0-144445-e93b",
"file_hash": "2758eda4b7836458bd1d717a50e4625c",
"height": 1024,
"uri": "v12044gd0000d192fcnog65ouluk5f60",
"url_key": "v12044gd0000d192fcnog65ouluk5f60_bytevc1_540p_630504",
"url_list": [
"https://v45.tiktokcdn-eu.com/6f7ee0f58f0c58d39943fdbb31ca96b5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oIekjEYsQQkaIGHHWCpXd69QIUMgqZAKlA8e2f/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1230&bt=615&cs=2&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=11&rc=NDVlZmk0MzY8ZDg3OWU4Z0BpM2lub3I5cmY1NDMzZzczNEAxLmM0Ni5fX14xMl9fNTMxYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"
],
"url_prefix": null,
"width": 576
},
"play_addr_h264": {
"data_size": 23315651,
"file_cs": "c:0-143697-b9bb",
"file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
"height": 1024,
"uri": "v12044gd0000d192fcnog65ouluk5f60",
"url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
"url_list": [
"https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"
],
"url_prefix": null,
"width": 576
},
"ratio": "540p",
"source_HDR_type": 0,
"tags": null,
"vid_profile_labels": "{\"tier3\":\"10059\"}",
"video_model": "",
"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-maliva-avt-0068/7310178711609032710",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_larger": {
"height": 720,
"uri": "tos-maliva-avt-0068/7310178711609032710",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "tos-maliva-avt-0068/7310178711609032710",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"
],
"url_prefix": null,
"width": 720
},
"avatar_uri": "tos-maliva-avt-0068/7310178711609032710",
"aweme_count": 0,
"bind_phone": "",
"bold_fields": null,
"can_message_follow_status_list": [
0
],
"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": "Account verificato",
"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,
"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": true,
"homepage_bottom_toast": null,
"ins_id": "stoolpresidente",
"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": "en",
"live_agreement": 0,
"live_commerce": false,
"live_verify": 0,
"mention_status": 1,
"mutual_relation_avatars": null,
"need_points": null,
"need_recommend": 0,
"nickname": "Dave Portnoy",
"platform_sync_info": null,
"prevent_download": false,
"react_setting": 0,
"region": "US",
"relative_users": null,
"reply_with_video_flag": 4,
"room_id": 0,
"search_highlight": null,
"sec_uid": "MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD",
"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": "El Presidente/Barstool Sports Founder.",
"special_account": {
"special_account_list": null
},
"special_lock": 1,
"status": 1,
"stitch_setting": 0,
"story_status": 0,
"total_favorited": 0,
"tw_expire_time": 0,
"twitter_id": "",
"twitter_name": "",
"type_label": null,
"uid": "6659752019493208069",
"unique_id": "stoolpresidente",
"unique_id_modify_time": 1750289178,
"user_canceled": false,
"user_mode": 1,
"user_now_pack_info": {},
"user_period": 0,
"user_profile_guide": null,
"user_rate": 17,
"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
},
"create_time": 1750214725,
"is_ad": false,
"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"
},
"transcript": "WEBVTT\n\n\n00:00:00.340 --> 00:00:01.860\nAll right. W N B A. Rant.\n\n00:00:01.861 --> 00:00:02.741\nI know. It's like,\n\n00:00:02.742 --> 00:00:03.261\noh, Dave,\n\n00:00:03.262 --> 00:00:04.941\nwe don't wanna hear about you in the W N B A.\n\n00:00:04.942 --> 00:00:06.781\nI'm sorry. I fucking love it,",
"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_detail": {
"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"
]
}
}
},
"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"
},
"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"
},
"is_long_video": {
"type": "integer"
},
"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"
},
"video_model": {
"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_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_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"
},
"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"
},
"story_status": {
"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"
}
}
},
"create_time": {
"type": "integer"
},
"is_ad": {
"type": "boolean"
},
"is_eligible_for_commission": {
"type": "boolean"
},
"is_paid_partnership": {
"type": "boolean"
},
"create_time_utc": {
"type": "string"
},
"url": {
"type": "string"
},
"shop_product_url": {
"type": "string"
}
}
},
"transcript": {
"type": "string"
},
"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."
}
}
}