Using Ruby
How to Scrape TikTok Keyword Search with Ruby
Search TikTok videos by keyword with filters using Ruby. This comprehensive guide will walk you through the entire process, from setup to implementation.
Overview
What You'll Learn
- Setting up your Ruby environment
- Installing the required HTTP client
- Authenticating with SociaVault API
- Making requests to TikTok
- Handling responses and errors
What You'll Get
- Access to search keyword data
- JSON formatted responses
- Real-time data access
- Scalable solution
- Error handling patterns
Prerequisites
1. API Key
First, you'll need a SociaVault API key to authenticate your requests.
2. Development Environment
Make sure you have the following installed:
- Ruby installed
- A code editor (VS Code, Sublime, etc.)
- Command line interface access
Implementation
Step 1: Install HTTP Client
We'll use net/http to make HTTP requests.
bash
# Standard libraryStep 2: API Implementation
Now let's make a request to the TikTok API using Ruby. Replace YOUR_API_KEY with your actual API key.
ruby
require 'net/http'
require 'json'
url = URI("https://api.sociavault.com/tiktok/search/keyword?query=cooking")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = "YOUR_API_KEY"
request["Content-Type"] = "application/json"
response = http.request(request)
puts response.read_bodyTesting Your Code
API Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Example: cooking |
Expected Response
You should receive a structured JSON response containing the search keyword data.
json
{
"cursor": 12,
"search_item_list": [
{
"aweme_info": {
"added_sound_music_info": {
"album": "Yeah! (feat. Lil Jon & Ludacris)",
"allow_offline_music_to_detail_page": false,
"artists": [
{
"avatar": {
"uri": "tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce~tplv-tiktokx-cropcenter-q:168:168:q75.webp?dr=9604&idc=no1a&nonce=55741&ps=87d6e48a&refresh_token=da514b973402e5a0d5fcd41636b64929&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
]
},
"enter_type": 2,
"follow_status": 0,
"follower_status": 0,
"handle": "usher",
"is_block": false,
"is_blocked": false,
"is_private_account": false,
"is_verified": true,
"is_visible": false,
"nick_name": "Usher Raymond",
"sec_uid": "MS4wLjABAAAA2qFUyY878XlTp6vlLi2LWROamZKwkQfqRLMHo8O0UizXpnO-yXE2qR7QZKRCJJy_",
"status": 1,
"uid": "6779798771846431749"
}
],
"audition_duration": 60,
"author": "Usher",
"author_deleted": false,
"avatar_medium": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:720:720:q75.webp?dr=9607&idc=no1a&nonce=17377&ps=87d6e48a&refresh_token=77046454af816fde091c2cbfc94ae998&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:100:100:q75.webp?dr=9606&idc=no1a&nonce=88621&ps=87d6e48a&refresh_token=a2a2bc1faf0d645ac7826709b90b86fe&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"binded_challenge_id": 0,
"can_be_stitched": false,
"can_not_reuse": false,
"collect_stat": 0,
"commercial_right_type": 3,
"cover_large": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"cover_medium": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"cover_thumb": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"create_time": 1646767514,
"dmv_auto_show": false,
"duration": 60,
"duration_high_precision": {
"audition_duration_precision": 60,
"duration_precision": 60,
"shoot_duration_precision": 60,
"video_duration_precision": 60
},
"extra": "{\"amplitude_peak\":1.1201035,\"beats\":{\"audio_effect_onset\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/439648c9db134eeea4626f1441f4fd85\",\"beats_tracker\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/2f63338020c14f2ead895158393d1688\",\"energy_trace\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/fc7e1ef3c7ab4fc997b8f5e657f86cab\",\"merged_beats\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/a3f0715ab5304acdb93e0e44c2911884\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":7339876632230134816,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-9.173245,\"music_vid\":\"v10ad6g50000cc1h183c77u9c47ldr4g\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":1,\"schedule_search_time\":0}",
"has_commerce_right": false,
"id": 7072812562194106000,
"id_str": "7072812562194106370",
"is_audio_url_with_cookie": false,
"is_author_artist": true,
"is_commerce_music": true,
"is_matched_metadata": false,
"is_original": false,
"is_original_sound": false,
"is_pgc": true,
"is_play_music": true,
"is_shooting_allow": true,
"language": "English",
"log_extra": "{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}",
"matched_song": {
"author": "Usher",
"chorus_info": {
"duration_ms": 27455,
"start_ms": 56064
},
"cover_medium": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"full_duration": 250420,
"h5_url": "",
"id": "7072812557722978305",
"title": "Yeah! (feat. Lil Jon & Ludacris)"
},
"mid": "7072812562194106370",
"music_release_info": {
"group_release_date": 1075132800,
"is_new_release_song": false
},
"mute_share": false,
"offline_desc": "",
"owner_handle": "",
"owner_nickname": "",
"play_url": {
"height": 720,
"uri": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/bfdf878344514bbcacec50e0475d3b52",
"url_list": [
"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/bfdf878344514bbcacec50e0475d3b52"
],
"width": 720
},
"prevent_download": false,
"preview_end_time": 0,
"preview_start_time": 0,
"recommend_status": 100,
"shoot_duration": 60,
"source_platform": 10033,
"status": 1,
"strong_beat_url": {
"height": 720,
"uri": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/okAAgIAuc7nCkm9BIpE1BFbtZAeDrgPDTIfDUG",
"url_list": [
"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/okAAgIAuc7nCkm9BIpE1BFbtZAeDrgPDTIfDUG"
],
"width": 720
},
"style_value": [
152
],
"theme_value": [
13
],
"title": "Yeah! (feat. Lil Jon & Ludacris)",
"user_count": 807750,
"video_duration": 60
},
"aigc_info": {
"aigc_label_type": 0,
"created_by_ai": false
},
"anchors": [
{
"component_key": "anchor_poi",
"description": "Location",
"extra": "{\"Name\":\"Kansas City\",\"poi_id\":\"22535865206014961\",\"city_code\":\"4393217\",\"region_code\":\"6252001\",\"poi_backend_type\":\"Place and Address,Places,City|19a3a0\",\"poi_info_source\":\"unknown\",\"video_count\":1092703,\"collect_info\":\"{\\\"tt_type_code\\\":\\\"19a3a0\\\",\\\"is_tt_key_category\\\":0,\\\"tt_poi_type_name_level0\\\":\\\"Place and Address\\\",\\\"fake_mining_grade\\\":\\\"5\\\",\\\"tt_poi_type_name_level1\\\":\\\"Place and Address\\\",\\\"is_display_distance\\\":0,\\\"poi_detail_type\\\":\\\"regional\\\",\\\"is_bad_case\\\":0,\\\"has_product\\\":0,\\\"is_product_visible\\\":0,\\\"has_service\\\":0,\\\"is_service_visible\\\":0,\\\"is_shop_url_visible\\\":0,\\\"poi_bizline\\\":\\\"\\\",\\\"local_service_key_category\\\":\\\"Others\\\",\\\"poi_class_name\\\":\\\"Regional\\\",\\\"has_commodity_ref_g1\\\":\\\"0\\\"}\",\"poi_mapkit_collect\":false,\"location\":{\"lat\":\"39.099726\",\"lng\":\"-94.578567\",\"geohash\":\"9yuwrvcurtm1\"},\"fallback_address\":\"Missouri, United States\",\"type_level\":\"1\",\"have_region_discovery\":true,\"fav_cnt\":2949,\"is_tt_key_category\":0,\"is_ls_key_category\":0,\"category_name\":\"City\",\"formatted_address\":\"Missouri, United States\"}",
"general_type": 1,
"icon": {
"height": 720,
"uri": "tiktok-obj/Map_Pin.png",
"url_list": [
"https://p77-sg.tiktokcdn.com/tiktok-obj/Map_Pin.png~tplv-tiktokx-origin.image?biz_tag=anchor.poi&dr=10423&idc=no1a&nonce=26515&ps=933b5bde&refresh_token=1b05ac1dae3762a985a8222edce24881&shcp=d05b14bd&shp=45126217&t=4d5b0474"
],
"width": 720
},
"id": "22535865206014961",
"keyword": "Kansas City",
"log_extra": "{\"anchor_id\":\"22535865206014961\",\"anchor_name\":\"Kansas City\",\"anchor_type\":\"poi\",\"is_ad_signal\":\"0\"}",
"schema": "aweme://poi/detail",
"thumbnail": {
"height": 64,
"uri": "tiktok-obj/poi_thumbnail_3x.png",
"url_list": [
"https://p77-sg.tiktokcdn.com/tiktok-obj/poi_thumbnail_3x.png~tplv-tiktokx-origin.image?dr=10423&nonce=72192&refresh_token=e95167b677b457545ba01f65c85b3c85&idc=no1a&ps=933b5bde&shcp=d05b14bd&shp=45126217&t=4d5b0474"
],
"width": 64
},
"type": 45
}
],
"anchors_extras": "",
"animated_image_info": {
"effect": 0,
"type": 0
},
"author": {
"accept_private_policy": false,
"authority_status": 0,
"avatar_168x168": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:168:168:q75.webp?dr=9604&idc=no1a&nonce=99229&ps=87d6e48a&refresh_token=dd4a296b31eaef0027111802d615157d&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_300x300": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:300:300:q75.webp?dr=9605&idc=no1a&nonce=8993&ps=87d6e48a&refresh_token=f09bfe350ccfdb7aa0ec0113a173402a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_larger": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:1080:1080:q75.webp?dr=9608&idc=no1a&nonce=25103&ps=87d6e48a&refresh_token=0a9eedb0f8fcb71ecaf4fe147294cc92&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_medium": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:720:720:q75.webp?dr=9607&idc=no1a&nonce=90575&ps=87d6e48a&refresh_token=278c1718b10c4c5a8090b1f0d56484de&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d~tplv-tiktokx-cropcenter-q:100:100:q75.webp?biz_tag=musically_video.video_user_cover&dr=9606&idc=no1a&nonce=77976&ps=87d6e48a&refresh_token=20a3d30293b0cf9782f7b42610a8c1a7&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_uri": "tos-maliva-avt-0068/43e401b82d50177d5869e4b00ef2505d",
"aweme_count": 0,
"can_message_follow_status_list": [
2
],
"comment_filter_status": 0,
"comment_setting": 0,
"commerce_user_level": 0,
"custom_verify": "",
"cv_level": "",
"download_prompt_ts": 0,
"enabled_filter_all_comments": false,
"enterprise_verify_reason": "",
"fb_expire_time": 0,
"follow_status": 0,
"follower_count": 25,
"follower_status": 0,
"following_count": 63,
"friends_status": 0,
"hide_search": false,
"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_star": false,
"live_agreement": 0,
"live_commerce": false,
"live_verify": 0,
"mention_status": 1,
"name_field": "nickname",
"need_recommend": 0,
"nickname": "Peter Griffin, fan",
"prevent_download": false,
"reply_with_video_flag": 4,
"room_id": 0,
"search_user_desc": "kansascitychiefsfan5",
"search_user_name": "Peter Griffin, fan",
"sec_uid": "MS4wLjABAAAASa520pr6SpRIlq4R8c8HoTu18GmYGiEVv6BDZmBQhSNjcdPIkvvPAOHRk6wwQMF2",
"secret": 0,
"shield_comment_notice": 0,
"shield_digg_notice": 0,
"shield_follow_notice": 0,
"short_id": "0",
"show_image_bubble": false,
"special_lock": 1,
"status": 1,
"stitch_setting": 0,
"story_status": 0,
"total_favorited": 0,
"uid": "7334608148841972782",
"unique_id": "kansascitychiefsfan5",
"user_canceled": false,
"user_mode": 1,
"user_period": 0,
"user_rate": 1,
"verification_type": 1,
"verify_info": "",
"video_icon": {
"height": 720,
"uri": "",
"width": 720
},
"with_commerce_entry": false,
"with_shop_entry": false
},
"author_user_id": 7334608148841973000,
"aweme_acl": {
"download_general": {
"code": 0,
"mute": false,
"show_type": 2,
"transcode": 3
},
"download_mask_panel": {
"code": 0,
"mute": false,
"show_type": 2,
"transcode": 3
},
"share_general": {
"code": 0,
"mute": false,
"show_type": 2,
"transcode": 3
},
"share_list_status": 0
},
"aweme_id": "7334621391758642478",
"aweme_type": 0,
"banners": [
{
"key": {
"component_key": "bottom_banner_search_rs"
}
}
],
"bodydance_score": 0,
"cc_template_info": {
"author_name": "",
"clip_count": 0,
"desc": "",
"duration_milliseconds": 0,
"related_music_id": "",
"template_id": ""
},
"cha_list": [
{
"cha_name": "superbowlhalftime",
"cid": "6297854",
"collect_stat": 0,
"desc": "",
"extra_attr": {
"is_live": false
},
"hashtag_profile": "",
"is_challenge": 0,
"is_commerce": false,
"is_pgcshow": false,
"schema": "aweme://aweme/challenge/detail?cid=6297854",
"share_info": {
"bool_persist": 0,
"share_desc": "Check out #superbowlhalftime on TikTok!",
"share_desc_info": "Check out #superbowlhalftime on TikTok!",
"share_quote": "",
"share_signature_desc": "",
"share_signature_url": "",
"share_title": "It is a becoming a big trend on TikTok now! Click here: superbowlhalftime",
"share_title_myself": "",
"share_title_other": "",
"share_url": "https://www.tiktok.com/tag/superbowlhalftime?_r=1&name=superbowlhalftime&u_code=ecl95fe242hb0g&_d=ecl9369b611jfk&share_challenge_id=6297854&sharer_language=en&source=h5_m"
},
"sub_type": 0,
"type": 1,
"use_count": 0,
"user_count": 0,
"view_count": 0
}
],
"cmt_swt": false,
"collect_stat": 0,
"comment_config": {
"preload": {
"preds": "{\"item_post_comment\":0.00015784323010386084}"
},
"quick_comment": {
"enabled": true
}
},
"commerce_info": {
"adv_promotable": false,
"auction_ad_invited": false,
"branded_content_type": 0,
"with_comment_filter_words": false
},
"content_desc": "",
"content_model": {
"custom_biz": {
"aweme_trace": "2025012420462477D7BDF0C82176619A80"
},
"standard_biz": {
"e_commerce": {
"ttec_content_tag": {
"recommendation_tag_consumer_str": "",
"recommendation_tag_creator_str": ""
}
},
"tts_voice_info": {
"tts_voice_attr": "[]",
"tts_voice_reuse_params": ""
},
"vc_filter_info": {
"vc_filter_attr": "[]"
}
}
},
"content_original_type": 1,
"content_size_type": 1,
"content_type": "video",
"create_time": 1707724682,
"creation_info": {
"creation_used_functions": [
"high_quality_upload"
]
},
"desc": "The most insane Super Bowl ever ‼️‼️‼️‼️#superbowlhalftime #SuperBowl #traviskelce #traviskelce #kansascitychiefs ",
"desc_language": "en",
"disable_search_trending_bar": false,
"distance": "",
"distribute_type": 2,
"follow_up_item_id_groups": "",
"follow_up_publish_from_id": -1,
"group_id": "7334560561012673822",
"group_id_list": {
"GroupdIdList0": [
7334560561012674000
],
"GroupdIdList1": [
7334560561012674000
]
},
"has_danmaku": false,
"has_promote_entry": 2,
"has_vs_entry": false,
"have_dashboard": false,
"interact_permission": {
"allow_adding_as_post": {
"status": 0
},
"allow_adding_to_story": 0,
"allow_create_sticker": {
"status": 0
},
"duet": 0,
"duet_privacy_setting": 0,
"stitch": 0,
"stitch_privacy_setting": 0,
"upvote": 0
},
"is_ads": false,
"is_description_translatable": true,
"is_hash_tag": 1,
"is_nff_or_nr": false,
"is_on_this_day": 0,
"is_pgcshow": false,
"is_preview": 0,
"is_relieve": false,
"is_text_sticker_translatable": false,
"is_title_translatable": false,
"is_top": 0,
"is_vr": false,
"item_comment_settings": 0,
"item_duet": 0,
"item_react": 0,
"item_stitch": 0,
"label_top": {
"height": 720,
"uri": "tiktok-obj/1598708589477025.PNG",
"url_list": [
"https://p77-sg.tiktokcdn.com/tiktok-obj/1598708589477025.PNG~tplv-tiktokx-origin.image?dr=10423&nonce=70891&refresh_token=d2007fa03df39cb52de015bd98b507ba&idc=no1a&ps=933b5bde&shcp=d05b14bd&shp=45126217&t=4d5b0474"
],
"width": 720
},
"main_arch_common": "",
"misc_info": "{}",
"music": {
"album": "Yeah! (feat. Lil Jon & Ludacris)",
"allow_offline_music_to_detail_page": false,
"artists": [
{
"avatar": {
"uri": "tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce~tplv-tiktokx-cropcenter-q:168:168:q75.webp?dr=9604&idc=no1a&nonce=55741&ps=87d6e48a&refresh_token=da514b973402e5a0d5fcd41636b64929&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
]
},
"enter_type": 2,
"follow_status": 0,
"follower_status": 0,
"handle": "usher",
"is_block": false,
"is_blocked": false,
"is_private_account": false,
"is_verified": true,
"is_visible": false,
"nick_name": "Usher Raymond",
"sec_uid": "MS4wLjABAAAA2qFUyY878XlTp6vlLi2LWROamZKwkQfqRLMHo8O0UizXpnO-yXE2qR7QZKRCJJy_",
"status": 1,
"uid": "6779798771846431749"
}
],
"audition_duration": 60,
"author": "Usher",
"author_deleted": false,
"avatar_medium": {
"height": 720,
"uri": "tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce~tplv-tiktokx-cropcenter-q:720:720:q75.webp?dr=9607&idc=no1a&nonce=97370&ps=87d6e48a&refresh_token=b9485e3d56e65cf76146fa9d97ee4e9d&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce",
"url_list": [
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/122719f01f36ed8578e8299237f9cdce~tplv-tiktokx-cropcenter-q:100:100:q75.webp?dr=9606&idc=no1a&nonce=56894&ps=87d6e48a&refresh_token=d8e3842c35adc58c7b21aa4de0716e52&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
],
"width": 720
},
"binded_challenge_id": 0,
"can_be_stitched": false,
"can_not_reuse": false,
"collect_stat": 0,
"commercial_right_type": 3,
"cover_large": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"cover_medium": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"cover_thumb": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"create_time": 1646767514,
"dmv_auto_show": false,
"duration": 60,
"duration_high_precision": {
"audition_duration_precision": 60,
"duration_precision": 60,
"shoot_duration_precision": 60,
"video_duration_precision": 60
},
"extra": "{\"amplitude_peak\":1.1201035,\"beats\":{\"audio_effect_onset\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/439648c9db134eeea4626f1441f4fd85\",\"beats_tracker\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/2f63338020c14f2ead895158393d1688\",\"energy_trace\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/fc7e1ef3c7ab4fc997b8f5e657f86cab\",\"merged_beats\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/a3f0715ab5304acdb93e0e44c2911884\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":7339876632230134816,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-9.173245,\"music_vid\":\"v10ad6g50000cc1h183c77u9c47ldr4g\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":1,\"schedule_search_time\":0}",
"has_commerce_right": false,
"id": 7072812562194106000,
"id_str": "7072812562194106370",
"is_audio_url_with_cookie": false,
"is_author_artist": true,
"is_commerce_music": true,
"is_matched_metadata": false,
"is_original": false,
"is_original_sound": false,
"is_pgc": true,
"is_play_music": true,
"is_shooting_allow": true,
"language": "English",
"log_extra": "{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}",
"matched_song": {
"author": "Usher",
"chorus_info": {
"duration_ms": 27455,
"start_ms": 56064
},
"cover_medium": {
"height": 720,
"uri": "tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b",
"url_list": [
"https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/385280e9815e440caa58a11fbeb04b6b.jpeg"
],
"width": 720
},
"full_duration": 250420,
"h5_url": "",
"id": "7072812557722978305",
"title": "Yeah! (feat. Lil Jon & Ludacris)"
},
"mid": "7072812562194106370",
"music_release_info": {
"group_release_date": 1075132800,
"is_new_release_song": false
},
"mute_share": false,
"offline_desc": "",
"owner_handle": "",
"owner_nickname": "",
"play_url": {
"height": 720,
"uri": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/bfdf878344514bbcacec50e0475d3b52",
"url_list": [
"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/bfdf878344514bbcacec50e0475d3b52"
],
"width": 720
},
"prevent_download": false,
"preview_end_time": 0,
"preview_start_time": 0,
"recommend_status": 100,
"shoot_duration": 60,
"source_platform": 10033,
"status": 1,
"strong_beat_url": {
"height": 720,
"uri": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/okAAgIAuc7nCkm9BIpE1BFbtZAeDrgPDTIfDUG",
"url_list": [
"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/okAAgIAuc7nCkm9BIpE1BFbtZAeDrgPDTIfDUG"
],
"width": 720
},
"style_value": [
152
],
"theme_value": [
13
],
"title": "Yeah! (feat. Lil Jon & Ludacris)",
"user_count": 807750,
"video_duration": 60
},
"music_begin_time_in_ms": 0,
"music_end_time_in_ms": 83833,
"music_selected_from": "edit_page_recommend",
"music_title_style": 0,
"music_volume": "10.550460",
"need_trim_step": false,
"need_vs_entry": false,
"no_selected_music": false,
"origin_volume": "100.000000",
"original_client_text": {
"markup_text": "The most insane Super Bowl ever ‼️‼️‼️‼️<h id=\"1882\">#superbowlhalftime</h> <h id=\"1889\">#SuperBowl</h> <h id=\"1902\">#traviskelce</h> <h id=\"1921\">#traviskelce</h> <h id=\"1946\">#kansascitychiefs</h> ",
"text_extra": [
{
"hashtag_id": "6297854",
"hashtag_name": "superbowlhalftime",
"is_commerce": false,
"sec_uid": "",
"tag_id": "1882",
"type": 1,
"user_id": ""
}
]
},
"playlist_blocked": false,
"poi_data": {
"address_info": {
"address": "Missouri, United States",
"city_code": "4393217",
"city_name": "",
"geohash": "9yuwrvcurtm1",
"l0_geoname_id": "6252001",
"lat": "39.099726",
"lng": "-94.578567",
"region_code": "6252001"
},
"collect_info": "{\"fake_mining_grade\":\"5\",\"has_commodity_ref_g1\":\"0\",\"has_product\":0,\"has_service\":0,\"is_author_country_compliance\":0,\"is_bad_case\":0,\"is_display_distance\":0,\"is_influencer_compliance\":1,\"is_influencer_compliance_including_control_group\":0,\"is_marketing_info_compliance\":1,\"is_product_visible\":0,\"is_service_visible\":0,\"is_shop_url_visible\":0,\"is_song_compliance\":0,\"is_tt_key_category\":0,\"local_service_key_category\":\"Others\",\"poi_bizline\":\"\",\"poi_class_name\":\"Regional\",\"poi_detail_type\":\"regional\",\"tt_poi_type_name_level0\":\"Place and Address\",\"tt_poi_type_name_level1\":\"Place and Address\",\"tt_type_code\":\"19a3a0\"}",
"comment_anchor": {
"has_sub_arrow": false,
"sub_tag_exp_time": 0,
"sub_tag_exp_type": 0,
"sub_tags": [
{
"name": "124.8M likes on posts of this place",
"priority": 1,
"type": 13
}
],
"suffix": "",
"track_info": "{\"poi_info\":\"xx_people_like\"}"
},
"icon": {
"height": 0,
"uri": "tiktok-obj/Map_Pin.png",
"url_list": [
"https://p77-sg.tiktokcdn.com/tiktok-obj/Map_Pin.png~tplv-tiktokx-origin.image?dr=10423&nonce=57421&refresh_token=3172d0e3199efb84411d568ca02835db&idc=no1a&ps=933b5bde&shcp=d05b14bd&shp=45126217&t=4d5b0474"
],
"width": 0
},
"info_source": "unknown",
"poi_id": "22535865206014961",
"poi_mapkit_collect": false,
"poi_name": "Kansas City",
"poi_type": "Place and Address,Places,City|19a3a0",
"thumbnail": {
"height": 64,
"uri": "tiktok-obj/poi_thumbnail_3x.png",
"url_list": [
"https://p77-sg.tiktokcdn.com/tiktok-obj/poi_thumbnail_3x.png~tplv-tiktokx-origin.image?dr=10423&nonce=26629&refresh_token=5db7f73e14d929f7c1af8d31eb76ff51&idc=no1a&ps=933b5bde&shcp=d05b14bd&shp=45126217&t=4d5b0474"
],
"width": 64
},
"type_level": "1",
"video_anchor": {
"has_sub_arrow": false,
"sub_tag_exp_time": 3000,
"sub_tag_exp_type": 2,
"sub_tags": [
{
"name": "136.2K people posted about this place",
"priority": 1,
"type": 2
}
],
"suffix": "",
"track_info": "{\"poi_info\":\"xx_people_visit\"}"
},
"video_count": 1092703
},
"poi_re_tag_signal": 0,
"prevent_download": false,
"promote_capcut_toggle": 0,
"promote_icon_text": "Promote",
"promote_toast": "Can’t promote due to audio copyright issue",
"promote_toast_key": "reason_cannot_promote_music",
"quick_reply_emojis": [
"😍"
],
"rate": 12,
"region": "US",
"risk_infos": {
"content": "",
"risk_sink": false,
"type": 0,
"vote": false,
"warn": false
},
"search_desc": "The most insane Super Bowl ever !!️!!️!!️!!️ #superbowlhalftime INSANE ENDING to the 2024 Super Bowl",
"share_info": {
"bool_persist": 0,
"share_desc": "Check out Peter Griffin, fan's video! #TikTok",
"share_desc_info": "TikTok: Make Every Second CountCheck out Peter Griffin, fan’s video! #TikTok > ",
"share_link_desc": "",
"share_quote": "",
"share_signature_desc": "",
"share_signature_url": "",
"share_title": "Check out Peter Griffin, fan’s video! #TikTok > ",
"share_title_myself": "",
"share_title_other": "",
"share_url": "https://www.tiktok.com/@kansascitychiefsfan5/video/7334621391758642478?_r=1&u_code=ecl95fe242hb0g&preview_pb=0&sharer_language=en&_d=ecl9369b611jfk&share_item_id=7334621391758642478&source=h5_m",
"whatsapp_desc": "Download TikTok and watch more fun videos:"
},
"share_url": "https://www.tiktok.com/@kansascitychiefsfan5/video/7334621391758642478?_r=1&u_code=ecl95fe242hb0g&preview_pb=0&sharer_language=en&_d=ecl9369b611jfk&share_item_id=7334621391758642478&source=h5_m",
"shoot_tab_name": "photo",
"social_interaction_blob": {
"auxiliary_model_content": "ChIKBPCfmI0KBPCfmIIKBPCfmLM="
},
"solaria_profile": {
"profile": "{\"play_time_prob_dist\":\"[800,0.4459,7720.6125]\"}"
},
"sort_label": "",
"standard_component_info": {
"banner_enabled": false
},
"statistics": {
"aweme_id": "7334621391758642478",
"collect_count": 30,
"comment_count": 5,
"digg_count": 355,
"download_count": 16,
"forward_count": 0,
"lose_comment_count": 0,
"lose_count": 0,
"play_count": 31677,
"repost_count": 0,
"share_count": 22,
"whatsapp_share_count": 6
},
"status": {
"allow_comment": true,
"allow_share": true,
"aweme_id": "7334621391758642478",
"download_status": 0,
"in_reviewing": false,
"is_delete": false,
"is_prohibited": false,
"private_status": 0,
"review_result": {
"review_status": 0
},
"reviewed": 0,
"self_see": false
},
"suggest_words": {
"suggest_words": [
{
"hint_text": "Search · ",
"qrec_virtual_enable": "",
"scene": "feed_bar",
"words": [
{
"penetrate_info": "{\"lvl1_category_id\":\"\",\"is_time_sensitive\":\"0\",\"generate_time\":\"0\",\"hot_level\":\"0\",\"word_type_list\":\"\",\"predict_ctr_score\":0.004017964625750429,\"is_ramandan_promotion\":\"\",\"ecom_trigger_info\":\"\",\"lvl3_cate_list\":\"\",\"ecom_intent\":\"0\",\"ecom_trigger_info_map\":\"\"}",
"word": "2025 super bowl",
"word_id": "2257940335911144874",
"word_record": {
"words_lang": "en"
}
}
]
}
]
},
"support_danmaku": false,
"text_extra": [
{
"end": 58,
"hashtag_id": "6297854",
"hashtag_name": "superbowlhalftime",
"is_commerce": false,
"sec_uid": "",
"start": 40,
"type": 1,
"user_id": ""
}
],
"text_sticker_major_lang": "un",
"title_language": "un",
"ttt_product_recall_type": -2,
"upvote_info": {
"friends_recall_info": "{}",
"repost_initiate_score": 0,
"user_upvoted": false
},
"upvote_preload": {
"need_pull_upvote_info": false
},
"used_full_song": false,
"user_digged": 0,
"video": {
"CoverTsp": 0,
"ai_dynamic_cover": {
"uri": "tos-useast5-p-0068-tx/622ea84b20024465881ab5b4182ab175_1707724683",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/622ea84b20024465881ab5b4182ab175_1707724683~tplv-tiktokx-origin.image?dr=9229&nonce=29182&refresh_token=8d1c81cf3a7d606d3614129b133f4c83&x-expires=1737835200&x-signature=tw8kwrfRyLIXYTC2pU%2F%2BgHeu4dc%3D&biz_tag=tt_video&idc=no1a&ps=4f5296ae&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480"
]
},
"ai_dynamic_cover_bak": {
"uri": "tos-useast5-p-0068-tx/622ea84b20024465881ab5b4182ab175_1707724683",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/622ea84b20024465881ab5b4182ab175_1707724683~tplv-tiktokx-origin.image?dr=9229&nonce=29182&refresh_token=8d1c81cf3a7d606d3614129b133f4c83&x-expires=1737835200&x-signature=tw8kwrfRyLIXYTC2pU%2F%2BgHeu4dc%3D&biz_tag=tt_video&idc=no1a&ps=4f5296ae&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480"
]
},
"animated_cover": {
"uri": "tos-useast5-p-0068-tx/622ea84b20024465881ab5b4182ab175_1707724683",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/622ea84b20024465881ab5b4182ab175_1707724683~tplv-tiktokx-origin.image?dr=9229&nonce=29182&refresh_token=8d1c81cf3a7d606d3614129b133f4c83&x-expires=1737835200&x-signature=tw8kwrfRyLIXYTC2pU%2F%2BgHeu4dc%3D&biz_tag=tt_video&idc=no1a&ps=4f5296ae&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480"
]
},
"big_thumbs": [
{
"duration": 83.850517,
"fext": "jpeg",
"img_num": 84,
"img_uris": [
"tos-maliva-p-0068c799-us/4c39bb0f2b9746af94d6332d811526b4_1707724687"
],
"img_url": "",
"img_urls": [
"https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/4c39bb0f2b9746af94d6332d811526b4_1707724687~tplv-noop.image?x-expires=1737838067&x-signature=fBSE52mfMJeyKv5iRfmVERfvhHc%3D"
],
"img_x_len": 5,
"img_x_size": 136,
"img_y_len": 5,
"img_y_size": 240,
"interval": 1,
"uri": ""
}
],
"bit_rate": [
{
"HDR_bit": "",
"HDR_type": "",
"bit_rate": 720429,
"fps": 29,
"gear_name": "adapt_540_1",
"is_bytevc1": 1,
"play_addr": {
"data_size": 7551089,
"file_cs": "c:0-70516-ba01",
"file_hash": "097f81f42691eb4aa88a8c82b6a4fd17",
"height": 1024,
"uri": "v12044gd0000cn4suufog65pkilpo7og",
"url_key": "v12044gd0000cn4suufog65pkilpo7og_bytevc1_540p_720429",
"url_list": [
"https://v45.tiktokcdn-eu.com/2d6f54b76b0410de1fc746eb33927f56/67954df3/video/tos/maliva/tos-maliva-ve-0068c799-us/ooIE2ilpcBHHDuB9EfpIMSQgiAwKxy58c5eARn/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1406&bt=703&cs=2&ds=6&ft=pCXrRMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=11&rc=Ojg8OzpmaDw0NjQ8PDs2Z0BpajpzbHM5cnh2cTMzZzczNEBfYy0zMDU0NjQxXjI2Li5eYSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00095000"
],
"width": 576
},
"quality_type": 28,
"video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 190572}, {\\\"time\\\": 2, \\\"offset\\\": 257800}, {\\\"time\\\": 3, \\\"offset\\\": 322211}, {\\\"time\\\": 4, \\\"offset\\\": 405272}, {\\\"time\\\": 5, \\\"offset\\\": 500430}, {\\\"time\\\": 10, \\\"offset\\\": 893592}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"ori\\\": {\\\"v1080\\\": 85.745, \\\"v960\\\": 87.884, \\\"v864\\\": 90.711, \\\"v720\\\": 93.151}, \\\"srv1\\\": {\\\"v1080\\\": 97.048, \\\"v960\\\": 97.362, \\\"v864\\\": 98.857, \\\"v720\\\": 99.188}}}\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"d2855c583ab7dd2f69b34dc4f402cebc\"}"
}
],
"cdn_url_expired": 0,
"cla_info": {
"caption_infos": [
{
"caption_format": "webvtt",
"caption_length": 873,
"cla_subtitle_id": 7376845579634347000,
"complaint_id": 7376845579634347000,
"expire": 1740343667,
"is_auto_generated": true,
"is_original_caption": true,
"lang": "eng-US",
"language_code": "en",
"language_id": 2,
"source_tag": "vv_counter,",
"sub_id": 2047400632,
"sub_version": "1",
"subtitle_type": 1,
"translation_type": 0,
"translator_id": 0,
"url": "https://v19-cla.tiktokcdn.com/5a9919cbdac900a6544f6caf1c9fa3f0/67bb8973/video/tos/maliva/tos-maliva-v-0068c799-us/26a0a8e1a034416e8a1734e3d245b60e/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3280&bt=1640&cs=0&ds=6&ft=4flrFMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=13&rc=ajpzbHM5cnh2cTMzZzczNEBpajpzbHM5cnh2cTMzZzczNEBsbGloMmRjcjFgLS1kMS9zYSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00050000",
"url_list": [
"https://v19-cla.tiktokcdn.com/5a9919cbdac900a6544f6caf1c9fa3f0/67bb8973/video/tos/maliva/tos-maliva-v-0068c799-us/26a0a8e1a034416e8a1734e3d245b60e/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3280&bt=1640&cs=0&ds=6&ft=4flrFMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=13&rc=ajpzbHM5cnh2cTMzZzczNEBpajpzbHM5cnh2cTMzZzczNEBsbGloMmRjcjFgLS1kMS9zYSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00050000"
],
"variant": "whisper_lid"
}
],
"captions_type": 1,
"creator_edited_caption_id": 0,
"enable_auto_caption": 0,
"has_original_audio": 1,
"hide_original_caption": false,
"no_caption_reason": 0,
"original_language_info": {
"can_translate_realtime": false,
"can_translate_realtime_skip_translation_lang_check": true,
"first_subtitle_time": 0,
"is_burnin_caption": false,
"lang": "eng-US",
"language_code": "en",
"language_id": 2,
"original_caption_type": 1
}
},
"cover": {
"height": 720,
"uri": "tos-useast5-p-0068-tx/ociku3REEDAf4IXJAlOgKxpcSBieHzyBcmY8K5",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ociku3REEDAf4IXJAlOgKxpcSBieHzyBcmY8K5~c5_500x800.jpeg?biz_tag=musically_video.video_cover&lk3s=c1333099&nonce=7655&refresh_token=ddf9311cd116befba20f27654a370ff5&shcp=-&shp=c1333099&x-expires=1737770400&x-signature=HOqh9FS%2BV8GXaCkPJ4KdvRYirmI%3D"
],
"width": 720
},
"download_addr": {
"data_size": 19157722,
"file_cs": "c:0-68150-dd61",
"height": 720,
"uri": "v12044gd0000cn4suufog65pkilpo7og",
"url_list": [
"https://v45.tiktokcdn-eu.com/3ce05877e4cf101fc2b78c0ee6b01f15/67954df3/video/tos/maliva/tos-maliva-ve-0068c799-us/o8IEJilpcBSHDuBEEfP7RSQgiB0Kxy58cTeARB/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3568&bt=1784&cs=0&ds=3&ft=pCXrRMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=0&rc=PDM0Z2Q0ZGhpZTtnZjk0OkBpajpzbHM5cnh2cTMzZzczNEAtYzQ0YS41Ni0xYmFgLjUxYSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00095000"
],
"width": 720
},
"download_no_watermark_addr": {
"data_size": 17610810,
"file_cs": "c:0-68150-dd61",
"file_hash": "58594bea0fc2d2e561ab7a40ce45d591",
"height": 1024,
"uri": "v12044gd0000cn4suufog65pkilpo7og",
"url_key": "v12044gd0000cn4suufog65pkilpo7og_h264_540p_1680200",
"url_list": [
"https://v45.tiktokcdn-eu.com/00a6a618bed56887cca393e2462d3f64/67954df3/video/tos/maliva/tos-maliva-ve-0068c799-us/oo0EifcT4gTRDphIgczEA5BSnDyFQJeVlP9Sl2/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3280&bt=1640&cs=0&ds=6&ft=pCXrRMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=0&rc=NTc2ZDc3NzM7N2gzZjk7PEBpajpzbHM5cnh2cTMzZzczNEAtYzAzMS4tXy0xMV4tNDQ0YSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00095000"
],
"width": 576
},
"duration": 83851,
"dynamic_cover": {
"height": 720,
"uri": "tos-useast5-p-0068-tx/3a1359963da94ff3a1717140ebacf30a_1707724684",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/3a1359963da94ff3a1717140ebacf30a_1707724684~tplv-tiktokx-origin.image?dr=9229&nonce=48562&refresh_token=65e7ba1ab2227746267fc677122f91c4&x-expires=1737835200&x-signature=5zD%2B%2BDcC1tYyyOOR%2BPcR8sAmGh4%3D&biz_tag=tt_video&idc=no1a&ps=4f5296ae&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480"
],
"width": 720
},
"has_watermark": true,
"height": 1024,
"is_bytevc1": 0,
"is_callback": true,
"is_long_video": 1,
"meta": "{\"LoudnessRange\":\"4.6\",\"LoudnessRangeEnd\":\"-20\",\"LoudnessRangeStart\":\"-24.7\",\"MaximumMomentaryLoudness\":\"-6.4\",\"MaximumShortTermLoudness\":\"-13.3\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-24.7,\\\"LoudnessRangeEnd\\\":-20,\\\"LoudnessRange\\\":4.6,\\\"Loudness\\\":-21.3,\\\"MaximumShortTermLoudness\\\":-13.3,\\\"Version\\\":2,\\\"Metrics\\\":{\\\"Version\\\":\\\"1.4.2\\\",\\\"Loudness\\\":{\\\"Integrated\\\":-21.274},\\\"Phase\\\":{\\\"RMSDownmixDiff\\\":-0.191},\\\"RMSStats\\\":{\\\"LRDiff\\\":0.101,\\\"Peak\\\":0.086,\\\"LTotal\\\":-23.68,\\\"RTotal\\\":-23.781},\\\"Cutoff\\\":{\\\"FCenL\\\":2863.67,\\\"FCenR\\\":2920.98,\\\"Spkr200G\\\":0.99,\\\"Spkr150G\\\":0.89,\\\"Spkr100G\\\":0.58},\\\"AEDInfo\\\":{\\\"SpeechRatio\\\":0.45,\\\"MusicRatio\\\":0.37,\\\"SingingRatio\\\":0}},\\\"Peak\\\":1,\\\"MaximumMomentaryLoudness\\\":-6.4}\",\"flight_id\":\"\",\"loudness\":\"-21.3\",\"peak\":\"1\",\"play_time_prob_dist\":\"[800,0.4459,7720.6125]\",\"qprf\":\"1.000\",\"sr_score\":\"1.000\",\"vq_score\":\"68.65\"}",
"need_set_token": false,
"origin_cover": {
"height": 720,
"uri": "tos-useast5-p-0068-tx/bd10d003abeb4e9e842735ed0cfa1078_1707724683",
"url_list": [
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/bd10d003abeb4e9e842735ed0cfa1078_1707724683~tplv-dmt-adapt-360p.heic?dr=1360&nonce=4162&refresh_token=d5794f561b14109373b15b8ce8257220&x-expires=1737835200&x-signature=Z1g4K3pWmv8urvcmxbVbcuJl8VM%3D&biz_tag=tt_video&idc=no1a&ps=d97f9a4f&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480"
],
"width": 720
},
"play_addr": {
"data_size": 17610810,
"file_cs": "c:0-68150-dd61",
"file_hash": "58594bea0fc2d2e561ab7a40ce45d591",
"height": 1024,
"uri": "v12044gd0000cn4suufog65pkilpo7og",
"url_key": "v12044gd0000cn4suufog65pkilpo7og_h264_540p_1680200",
"url_list": [
"https://v45.tiktokcdn-eu.com/00a6a618bed56887cca393e2462d3f64/67954df3/video/tos/maliva/tos-maliva-ve-0068c799-us/oo0EifcT4gTRDphIgczEA5BSnDyFQJeVlP9Sl2/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3280&bt=1640&cs=0&ds=6&ft=pCXrRMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=0&rc=NTc2ZDc3NzM7N2gzZjk7PEBpajpzbHM5cnh2cTMzZzczNEAtYzAzMS4tXy0xMV4tNDQ0YSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00095000"
],
"width": 576
},
"play_addr_bytevc1": {
"data_size": 7551089,
"file_cs": "c:0-70516-ba01",
"file_hash": "097f81f42691eb4aa88a8c82b6a4fd17",
"height": 1024,
"uri": "v12044gd0000cn4suufog65pkilpo7og",
"url_key": "v12044gd0000cn4suufog65pkilpo7og_bytevc1_540p_720429",
"url_list": [
"https://v45.tiktokcdn-eu.com/2d6f54b76b0410de1fc746eb33927f56/67954df3/video/tos/maliva/tos-maliva-ve-0068c799-us/ooIE2ilpcBHHDuB9EfpIMSQgiAwKxy58c5eARn/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1406&bt=703&cs=2&ds=6&ft=pCXrRMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=11&rc=Ojg8OzpmaDw0NjQ8PDs2Z0BpajpzbHM5cnh2cTMzZzczNEBfYy0zMDU0NjQxXjI2Li5eYSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00095000"
],
"width": 576
},
"play_addr_h264": {
"data_size": 17610810,
"file_cs": "c:0-68150-dd61",
"file_hash": "58594bea0fc2d2e561ab7a40ce45d591",
"height": 1024,
"uri": "v12044gd0000cn4suufog65pkilpo7og",
"url_key": "v12044gd0000cn4suufog65pkilpo7og_h264_540p_1680200",
"url_list": [
"https://v45.tiktokcdn-eu.com/00a6a618bed56887cca393e2462d3f64/67954df3/video/tos/maliva/tos-maliva-ve-0068c799-us/oo0EifcT4gTRDphIgczEA5BSnDyFQJeVlP9Sl2/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3280&bt=1640&cs=0&ds=6&ft=pCXrRMVc8Zmo0lBScb4jV~Y.p31rKsd.&mime_type=video_mp4&qs=0&rc=NTc2ZDc3NzM7N2gzZjk7PEBpajpzbHM5cnh2cTMzZzczNEAtYzAzMS4tXy0xMV4tNDQ0YSNsbGloMmRjcjFgLS1kMS9zcw%3D%3D&vvpl=1&l=2025012420462477D7BDF0C82176619A80&btag=e00095000"
],
"width": 576
},
"ratio": "540p",
"source_HDR_type": 0,
"video_model": "",
"width": 576
},
"video_control": {
"allow_download": false,
"allow_duet": true,
"allow_dynamic_wallpaper": true,
"allow_music": true,
"allow_react": true,
"allow_stitch": true,
"draft_progress_bar": 1,
"prevent_download_type": 2,
"share_type": 0,
"show_progress_bar": 1,
"timer_status": 1
},
"with_promotional_music": false,
"without_watermark": false,
"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"
},
"search_aweme_info": {
"has_creation_intention": false
}
}
]
}Best Practices
Error Handling
Implement comprehensive error handling and retry logic for failed requests. Log errors properly for debugging.
Caching
Cache responses when possible to reduce API calls and improve performance. Consider data freshness requirements.
Security
Never expose your API key in client-side code. Use environment variables and secure key management practices.
Troubleshooting
401
Unauthorized
Check your API key is correct and properly formatted in the x-api-key header.
402
Payment Required
You ran out of credits and need to buy more.
404
Not Found
The resource (user, video, etc.) might not exist or be private.
429
Too Many Requests
You have exceeded your rate limit. Slow down your requests.
Frequently Asked Questions
How much does it cost to scrape TikTok?
SociaVault offers 50 free API calls to get started. After that, pricing starts at $10 for 5k requests with volume discounts available.
Is it legal to scrape TikTok data?
Scraping publicly available data is generally considered legal. We only collect public data that is accessible without logging in.
How fast can I scrape TikTok?
Our API handles the rate limiting for you. You can make requests as fast as your plan allows.
What data format does the API return?
All API responses are returned in JSON format, making it easy to integrate with any programming language or application.
Related Tutorials
Keyword Search in Other Languages
Keyword Search with Node.jsKeyword Search with JavaScriptKeyword Search with PythonKeyword Search with PHPReady to Start Scraping?
Get started with 50 free API calls. No credit card required. Stop worrying about proxies and captchas.