{ "openapi": "3.1.0", "info": { "title": "TikTok Data API", "version": "1.0.0" }, "paths": { "/v1/user/resolve": { "get": { "tags": [ "User" ], "summary": "Resolve User by Username", "description": "Resolve a @handle to a user profile (secUid, stats, avatar).\n\nThe cheapest way to turn a username into the secUid required by most\nother endpoints. Exact handle match first; display-name search\nfallback. Positive results are cached permanently (secUid never\nchanges).", "operationId": "resolveUser", "parameters": [ { "name": "uniqueId", "in": "query", "required": false, "schema": { "type": "string", "description": "TikTok @username without the @ sign, e.g. tiktok.", "title": "Uniqueid", "default": "khaby.lame", "example": "khaby.lame" }, "description": "TikTok @username without the @ sign, e.g. tiktok." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "uid": "127905465618821121", "nickname": "Khabane lame", "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "avatar_thumb": { "uri": "tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=9640&idc=useast5&ps=13740610&refresh_token=9e03bd4c&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1788674400&x-signature=D0prbxJW2Amz5ozxea%2BdvKKIg0g%3D" ], "width": 720, "height": 720, "url_prefix": null }, "follow_status": 0, "follower_count": 162800000, "total_favorited": 2668672935, "custom_verify": "Popular creator", "unique_id": "khaby.lame", "room_id": 0, "enterprise_verify_reason": "", "followers_detail": null, "platform_sync_info": null, "geofencing": null, "cover_url": null, "item_list": null, "type_label": null, "ad_cover_url": null, "relative_users": null, "cha_list": null, "sec_uid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "need_points": null, "homepage_bottom_toast": null, "can_set_geofencing": null, "white_cover_url": null, "user_tags": null, "bold_fields": null, "search_highlight": null, "mutual_relation_avatars": null, "room_id_str": "0", "events": null, "advance_feature_item_order": null, "advanced_feature_info": null, "user_profile_guide": null, "shield_edit_field_info": null, "can_message_follow_status_list": null, "account_labels": null } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/user/info": { "get": { "tags": [ "User" ], "summary": "Get User Info", "description": "Get user profile by username (uniqueId) or numeric user ID.\n\nReturns the full user object: nickname, uniqueId, uid, secUid,\nsignature, verified status, avatar URLs, and stats (followerCount,\nfollowingCount, heartCount, videoCount). Provide either uniqueId or\nuserId - one of the two is required.", "operationId": "getUserInfo", "parameters": [ { "name": "uniqueId", "in": "query", "required": false, "schema": { "description": "TikTok @username without the @ sign, e.g. tiktok. One of uniqueId/userId is required.", "title": "Uniqueid", "type": "string", "default": "khaby.lame", "example": "khaby.lame" }, "description": "TikTok @username without the @ sign, e.g. tiktok. One of uniqueId/userId is required." }, { "name": "userId", "in": "query", "required": false, "schema": { "description": "Numeric user id - userInfo.user.id / author.id in any response.", "title": "Userid", "type": "string" }, "description": "Numeric user id - userInfo.user.id / author.id in any response." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "uid": "127905465618821121", "nickname": "Khabane lame", "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "avatar_thumb": { "uri": "tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=9640&idc=useast5&ps=13740610&refresh_token=9e03bd4c&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1788674400&x-signature=D0prbxJW2Amz5ozxea%2BdvKKIg0g%3D" ], "width": 720, "height": 720, "url_prefix": null }, "follow_status": 0, "follower_count": 162800000, "total_favorited": 2668672935, "custom_verify": "Popular creator", "unique_id": "khaby.lame", "room_id": 0, "enterprise_verify_reason": "", "followers_detail": null, "platform_sync_info": null, "geofencing": null, "cover_url": null, "item_list": null, "type_label": null, "ad_cover_url": null, "relative_users": null, "cha_list": null, "sec_uid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "need_points": null, "homepage_bottom_toast": null, "can_set_geofencing": null, "white_cover_url": null, "user_tags": null, "bold_fields": null, "search_highlight": null, "mutual_relation_avatars": null, "room_id_str": "0", "events": null, "advance_feature_item_order": null, "advanced_feature_info": null, "user_profile_guide": null, "shield_edit_field_info": null, "can_message_follow_status_list": null, "account_labels": null } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/user/posts": { "get": { "tags": [ "User" ], "summary": "Get User Posts", "description": "Get a user's posts (videos).\n\nReturns itemList[] with full video objects (id, desc, createTime,\nstats, video, music, author) plus hasMore/cursor for pagination.\nFirst request: cursor=0; pass the returned cursor to fetch the next\npage until hasMore is false.", "operationId": "getUserPosts", "parameters": [ { "name": "secUid", "in": "query", "required": false, "schema": { "type": "string", "description": "User secUid (base64, starts with MS4wLjAB). Resolve a @username via GET /v1/user/resolve, or take author.secUid from any post object.", "title": "Secuid", "default": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "example": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA" }, "description": "User secUid (base64, starts with MS4wLjAB). Resolve a @username via GET /v1/user/resolve, or take author.secUid from any post object." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "1785862131054", "extra": { "fatal_item_ids": [], "logid": "20260906150657D32B947C0ECC75EE4888", "now": 1788678417000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 104, "HasPromoteEntry": 0, "IsHDBitrate": false, "ShowAIGC": true, "author": { "UserStoryStatus": 0, "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "127905465618821121", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Khabane lame", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "secret": false, "shortDramaCreator": {}, "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "stitchSetting": 0, "uniqueId": "khaby.lame", "verified": true }, "authorStats": { "diggCount": 6745, "followerCount": 162800000, "followingCount": 81, "friendCount": 0, "heart": 2700000000, "heartCount": -1594967296, "videoCount": 1351 }, "authorStatsV2": { "diggCount": "6745", "followerCount": "162800000", "followingCount": "81", "friendCount": "0", "heart": "2700000000", "heartCount": "2700000000", "videoCount": "1351" }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "1697657584273413", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "learnfromkhaby" } ], "collected": false, "contents": [ { "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "textExtra": [ { "awemeId": "", "end": 47, "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 32, "subType": 0, "type": 1 } ] } ], "createTime": 1788539684, "creatorAIComment": { "copyright": "Summarized by AI. Mistakes are possible.", "eligibleVideo": true, "hasAITopic": true, "notEligibleReason": 0, "topicDescription": "Most frequently discussed topics", "topicName": "Topics", "topicSubDescription": "Know which discussions are trending among viewers with this list of AI-summarized topics." }, "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "digged": false, "diversificationId": 10000, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7681719358225239326", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Khabane lame", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 48, "id": "7681719448159619870", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oQEaap8Aiv8irZBEA3vGRClCzAoRAJuzaytAV/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7Th-Vn~GXq8Zmo&mime_type=audio_mpeg&rc=Mzt4dnE5cjxpZDMzaTU8NEBpMzt4dnE5cjxpZDMzaTU8NEAwb3E1MmRrM2FhLS1kMTJzYSMwb3E1MmRrM2FhLS1kMTJzcw%3D%3D&vvpl=1&l=20260906150657D32B947C0ECC75EE4888&VExpiration=1788764865&VSignature=gRwNxc316v18fQO5gEQ9RA&btag=e00048000&sp_exp=hash_v0", "private": false, "shoot_duration": 48, "title": "original sound", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "arb_content_safety_status": 102, "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "ec_global_verdict": 6, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 12600, "commentCount": 6854, "diggCount": 303900, "playCount": 2200000, "shareCount": 5127 }, "statsV2": { "collectCount": "12615", "commentCount": "6854", "diggCount": "303900", "playCount": "2200000", "repostCount": "0", "shareCount": "5127" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 47, "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 32, "subType": 0, "type": 1 } ], "textLanguage": "en", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 7596593, "FileCs": "c:0-30965-742b", "FileHash": "a4037025357a0bea245ef79e7efb3a45", "Height": 1280, "Uri": "v15044gf0000dadf5dfog65mh84jnv7g", "UrlKey": "v15044gf0000dadf5dfog65mh84jnv7g_h264_720p_1248566", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12NoYPJn-UxHc2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851265&l=20260906150657D32B947C0ECC75EE4888&ply_type=2&policy=2&signature=c9e1a22e685a05948d5907b893837844&tk=tt_chain_token&btag=e00088000" ], "Width": 720 }, "VQScore": "64.89", "bitrate": 1248566, "bitrateInfo": [ { "Bitrate": 1248566, "BitrateFPS": 23, "CodecType": "h264", "Format": "mp4", "GearName": "normal_720_0", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 88.754, \"v960\": 91.019, \"v864\": 92.23, \"v720\": 95.632}, \"ori\": {\"v1080\": 88.754, \"v960\": 91.019, \"v864\": 92.23, \"v720\": 95.632}}}", "PlayAddr": { "DataSize": 7596593, "FileCs": "c:0-30965-742b", "FileHash": "a4037025357a0bea245ef79e7efb3a45", "Height": 1280, "Uri": "v15044gf0000dadf5dfog65mh84jnv7g", "UrlKey": "v15044gf0000dadf5dfog65mh84jnv7g_h264_720p_1248566", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12NoYPJn-UxHc2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851265&l=20260906150657D32B947C0ECC75EE4888&ply_type=2&policy=2&signature=c9e1a22e685a05948d5907b893837844&tk=tt_chain_token&btag=e00088000" ], "Width": 720 }, "QualityType": 10, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 432411}, {\\\"time\\\": 2, \\\"offset\\\": 599887}, {\\\"time\\\": 3, \\\"offset\\\": 752883}, {\\\"time\\\": 4, \\\"offset\\\": 960464}, {\\\"time\\\": 5, \\\"offset\\\": 1279534}, {\\\"time\\\": 10, \\\"offset\\\": 2087308}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 88.754, \\\"v960\\\": 91.019, \\\"v864\\\": 92.23, \\\"v720\\\": 95.632}, \\\"ori\\\": {\\\"v1080\\\": 88.754, \\\"v960\\\": 91.019, \\\"v864\\\": 92.23, \\\"v720\\\": 95.632}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"65b88c41c0963253ad31b6f68981a242\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64215}" } ], "claInfo": { "enableAutoCaption": true, "hasOriginalAudio": true, "noCaptionReason": 3 }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=AeXHFNpadm77WV7WuEHFBTah28s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "720p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4qkVDaF1BfIvAFRtE3EBzYQGmEJAOfGDK8DEP/?a=1988&bti=ODszNWYuMDE6&&bt=1104&ft=-Csk_mH1PD12NoYPJn-UxHc2SY6e3wv25-cAp&mime_type=video_mp4&rc=PGk4OjQ3ZGc2MzdmNTY6OEBpanltO3A5cmdpZDMzaTczNEA0YDZfY2MyNi4xLTUxMDQyYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851265&l=20260906150657D32B947C0ECC75EE4888&ply_type=2&policy=2&signature=bbde1d318ffeb07f6f708e7c2364fdc6&tk=tt_chain_token&btag=e00088000", "duration": 48, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=AeXHFNpadm77WV7WuEHFBTah28s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1280, "id": "7681719358225239326", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oUSk82IQQQAqrYaeC5LU1gkvekVTfRAKGFeGDa~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=Wn9UnZ0EsfFDeRkqXKb86%2FRSsfU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12NoYPJn-UxHc2SY6e3wv25-cAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851265&l=20260906150657D32B947C0ECC75EE4888&ply_type=2&policy=2&signature=c9e1a22e685a05948d5907b893837844&tk=tt_chain_token&btag=e00088000", "ratio": "720p", "size": 7596593, "videoID": "v15044gf0000dadf5dfog65mh84jnv7g", "videoQuality": "normal", "volumeInfo": { "Loudness": -23.5, "Peak": 0.42658 }, "width": 720, "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=JTgDCxwrO1ZY1a9yoxXVSqR%2Fv%2BI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=4PZlOIHWxVBqUN2kTwOlT%2B1J7tE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=xfxMBBQ5hZ5ovkhw9th1WJWQWAc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=rUelNsgMB3uoXPjwGSZWaWmWi2k%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "20260906150657D32B947C0ECC75EE4888" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/user/playlist": { "get": { "tags": [ "User" ], "summary": "Get User Playlists", "description": "Get a user's playlists (collections).\n\nReturns playList[] (id, title, videoCount, cover) with cursor\npagination. An empty list simply means the user has no public\nplaylists.", "operationId": "getUserPlaylists", "parameters": [ { "name": "secUid", "in": "query", "required": false, "schema": { "type": "string", "description": "User secUid (base64, starts with MS4wLjAB). Resolve a @username via GET /v1/user/resolve, or take author.secUid from any post object.", "title": "Secuid", "default": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "example": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA" }, "description": "User secUid (base64, starts with MS4wLjAB). Resolve a @username via GET /v1/user/resolve, or take author.secUid from any post object." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "2", "extra": { "fatal_item_ids": [], "logid": "202609061508209D810923A7FDC27B32BC", "now": 1788678500000 }, "hasMore": false, "log_pb": { "impr_id": "202609061508209D810923A7FDC27B32BC" }, "playList": [ { "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-tiktokx-origin.image?dr=14575&x-expires=1788699600&x-signature=zM7U9LvKgquuGUaAcZqG9zGxxQA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "creator": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=fec24ece&x-expires=1788850800&x-signature=hARtu0GPwapJPUCfrS3UMyoKv30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=cd0302a5&x-expires=1788850800&x-signature=soDXZ%2BtRy6kIIKKvYhoEEPK9CsA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6487337b&x-expires=1788850800&x-signature=dw7peZrEd560d7uTLUnVobSf9hs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "ftc": false, "id": "7265646866401821738", "isADVirtual": false, "nickname": "dadsfoodtoday", "openFavorite": false, "privateAccount": true, "relation": 0, "secUid": "MS4wLjABAAAA7eCJ5F6pZzNzwgPvWw5rr1Y5MftaETOsftKGVDBoECj7im34SxXX6Kl3eG9FUlyb", "secret": true, "shortDramaCreator": {}, "signature": "Ben Decocker | NY 🇺🇸\nDad of 4 hungry boys\nQuick & Easy Family Meals \n👇 Get the full recipes", "uniqueId": "dadsfoodtoday", "verified": false }, "id": "7637624139910220558", "mixId": "7637624139910220558", "mixName": "Dinners 🔥", "name": "Dinners 🔥", "videoCount": 9 }, { "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o0AbAe3nGHDSLAfIvQIDAAIW0EkQbUdAgfjV1A~tplv-tiktokx-dmt-logom:tos-useast5-i-0068-tx/oYdEvBFaNEDF27AAaAAgfCEepoIaRslDSArABC.image?dr=14573&x-expires=1788699600&x-signature=03Apbq3vz3DKdyVRjhBWQmCI60k%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "creator": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=fec24ece&x-expires=1788850800&x-signature=hARtu0GPwapJPUCfrS3UMyoKv30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=cd0302a5&x-expires=1788850800&x-signature=soDXZ%2BtRy6kIIKKvYhoEEPK9CsA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6487337b&x-expires=1788850800&x-signature=dw7peZrEd560d7uTLUnVobSf9hs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "ftc": false, "id": "7265646866401821738", "isADVirtual": false, "nickname": "dadsfoodtoday", "openFavorite": false, "privateAccount": true, "relation": 0, "secUid": "MS4wLjABAAAA7eCJ5F6pZzNzwgPvWw5rr1Y5MftaETOsftKGVDBoECj7im34SxXX6Kl3eG9FUlyb", "secret": true, "shortDramaCreator": {}, "signature": "Ben Decocker | NY 🇺🇸\nDad of 4 hungry boys\nQuick & Easy Family Meals \n👇 Get the full recipes", "uniqueId": "dadsfoodtoday", "verified": false }, "id": "7629834839763471118", "mixId": "7629834839763471118", "mixName": "playlist_default_name", "name": "playlist_default_name", "videoCount": 44 } ], "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/user/dramas": { "get": { "tags": [ "User" ], "summary": "Get User Dramas", "description": "Get the mini-drama series a user appears in.\n\nReturns the user's drama list with cursor pagination.", "operationId": "getUserDramas", "parameters": [ { "name": "secUid", "in": "query", "required": false, "schema": { "type": "string", "description": "User secUid (base64, starts with MS4wLjAB). Resolve a @username via GET /v1/user/resolve, or take author.secUid from any post object.", "title": "Secuid", "default": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "example": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA" }, "description": "User secUid (base64, starts with MS4wLjAB). Resolve a @username via GET /v1/user/resolve, or take author.secUid from any post object." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "1", "dramaList": [ { "cover": { "urlList": [ "https://p19-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-tiktokx-origin.image?dr=14575&x-expires=1788854400&x-signature=HZ04xzqisqAk%2BQ3RP8AtgQ5XOIM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" ] }, "description": "Sau khi Gia Mơ và A Mi công khai bộc lộ sự lừa dối của họ, chế giễu những hy sinh của Ê Ma, cô ấy đứng vững với phẩm giá. Uy Liêm — người thừa kế Gia đình Lựu ngụy trang thành thợ sửa chữa — chứng kiến sự kiên cường của cô ấy. Khi A Mi đấu giá hợp đồng, sự im lặng bình tĩnh của anh ấy báo hiệu công lý đang đến gần: sự thật vượt qua sự lừa dối, sự tôn trọng vượt qua sự xấu hổ.", "dramaID": "7682314230347240468", "dramaName": "Chồng Thợ Nước Là Chủ Tịch Lựu", "isLimitedFree": true, "numVideos": 42, "numWatched": "81472", "themes": [ { "tagID": "7628991193716069392", "tagKey": "tag_Mistakenidentities_Relationship", "tagVal": "Mistaken Identities" } ], "totalDuration": "3670", "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1788854400&x-signature=v5TIfoKiDUAjrVfUUOtajmyvqu0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1788854400&x-signature=4hKh4FYuxvjK48h6H86hvPk7zdU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p19-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1788854400&x-signature=w3idNIWT1kFUXHVfHZ3vwFvOEM8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1788854400&x-signature=GKWJPwoYxKClHepn4woWg2L6H94%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } ], "extra": { "fatal_item_ids": [], "logid": "2026090616073936EC00851596E66F9EF5", "now": 1788682059000 }, "hasMore": true, "log_pb": { "impr_id": "2026090616073936EC00851596E66F9EF5" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/detail": { "get": { "tags": [ "Post" ], "summary": "Get Post Details", "description": "Get a single post (video) by its numeric video ID.\n\nReturns the full item struct: desc, createTime, stats/statsV2,\nvideo (playAddr, covers, duration, subtitleInfos), music, author,\nauthorStats. Works with a bare numeric ID - no author context\nneeded.", "operationId": "getPostDetail", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7681719358225239326", "example": "7681719358225239326" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "extra": { "fatal_item_ids": [], "logid": "202609061507007C0CF599064E4DE342E7", "now": 1788678420000 }, "itemInfo": { "itemStruct": { "AIGCDescription": "", "CategoryType": 104, "IsHDBitrate": false, "ShowAIGC": true, "author": { "UserStoryStatus": 0, "avatarLarger": "https://p19-common-sign.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6e8c56c8&x-expires=1788850800&x-signature=jMkEU5icKDcHY7ZpebSUCRzGzA8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=99412dfd&x-expires=1788850800&x-signature=MTUSwuiTFRBas%2BBpdVS9OHYk%2BNg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=049932ef&x-expires=1788850800&x-signature=1k5brYLWMN8qearptntg7DbRAj8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "127905465618821121", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Khabane lame", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "secret": false, "shortDramaCreator": {}, "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "stitchSetting": 0, "uniqueId": "khaby.lame", "verified": true }, "authorStats": { "diggCount": 6745, "followerCount": 162800000, "followingCount": 81, "friendCount": 0, "heart": 2700000000, "heartCount": -1594967296, "videoCount": 1351 }, "authorStatsV2": { "diggCount": "6745", "followerCount": "162800000", "followingCount": "81", "friendCount": "0", "heart": "2700000000", "heartCount": "2700000000", "videoCount": "1351" }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "1697657584273413", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "learnfromkhaby" } ], "collected": false, "contents": [ { "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "textExtra": [ { "awemeId": "", "end": 47, "hashtagId": "1697657584273413", "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 32, "subType": 0, "type": 1 } ] } ], "createTime": 1788539684, "creatorAIComment": { "copyright": "Summarized by AI. Mistakes are possible.", "eligibleVideo": true, "hasAITopic": true, "notEligibleReason": 0, "topicDescription": "Most frequently discussed topics", "topicName": "Topics", "topicSubDescription": "Know which discussions are trending among viewers with this list of AI-summarized topics." }, "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "digged": false, "diversificationId": 10000, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7681719358225239326", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Khabane lame", "coverLarge": "https://p19-common-sign.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6e8c56c8&x-expires=1788850800&x-signature=jMkEU5icKDcHY7ZpebSUCRzGzA8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=99412dfd&x-expires=1788850800&x-signature=MTUSwuiTFRBas%2BBpdVS9OHYk%2BNg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=049932ef&x-expires=1788850800&x-signature=1k5brYLWMN8qearptntg7DbRAj8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 48, "id": "7681719448159619870", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oQEaap8Aiv8irZBEA3vGRClCzAoRAJuzaytAV/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThgVn~GXq8Zmo&mime_type=audio_mpeg&rc=Mzt4dnE5cjxpZDMzaTU8NEBpMzt4dnE5cjxpZDMzaTU8NEAwb3E1MmRrM2FhLS1kMTJzYSMwb3E1MmRrM2FhLS1kMTJzcw%3D%3D&vvpl=1&l=202609061507007C0CF599064E4DE342E7&VExpiration=1788764868&VSignature=LQXImkqZQI9VLfoMfNaXBw&btag=e00048000&sp_exp=hash_v0", "private": false, "shoot_duration": 48, "title": "original sound", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "arb_content_safety_status": 102, "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "ec_global_verdict": 6, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 12600, "commentCount": 6854, "diggCount": 303900, "playCount": 2200000, "shareCount": 5127 }, "statsV2": { "collectCount": "12615", "commentCount": "6854", "diggCount": "303900", "playCount": "2200000", "repostCount": "0", "shareCount": "5127" }, "stitchDisplay": 0, "stitchEnabled": true, "suggestedWords": [ "Khaby Lame Speaking" ], "textExtra": [ { "awemeId": "", "end": 47, "hashtagId": "1697657584273413", "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 32, "subType": 0, "type": 1 } ], "textLanguage": "en", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 7596593, "FileCs": "c:0-30965-742b", "FileHash": "a4037025357a0bea245ef79e7efb3a45", "Height": 1280, "Uri": "v15044gf0000dadf5dfog65mh84jnv7g", "UrlKey": "v15044gf0000dadf5dfog65mh84jnv7g_h264_720p_1248566", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12NZYPJn-UxHt5bY6e3wv25zcAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851268&l=202609061507007C0CF599064E4DE342E7&ply_type=2&policy=2&signature=a1094cac7d016ffdbdaffa325ff5e0cf&tk=tt_chain_token&btag=e00088000" ], "Width": 720 }, "VQScore": "64.89", "bitrate": 1248566, "bitrateInfo": [ { "Bitrate": 1248566, "BitrateFPS": 23, "CodecType": "h264", "Format": "mp4", "GearName": "normal_720_0", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 88.754, \"v960\": 91.019, \"v864\": 92.23, \"v720\": 95.632}, \"ori\": {\"v1080\": 88.754, \"v960\": 91.019, \"v864\": 92.23, \"v720\": 95.632}}}", "PlayAddr": { "DataSize": 7596593, "FileCs": "c:0-30965-742b", "FileHash": "a4037025357a0bea245ef79e7efb3a45", "Height": 1280, "Uri": "v15044gf0000dadf5dfog65mh84jnv7g", "UrlKey": "v15044gf0000dadf5dfog65mh84jnv7g_h264_720p_1248566", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12NZYPJn-UxHt5bY6e3wv25zcAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851268&l=202609061507007C0CF599064E4DE342E7&ply_type=2&policy=2&signature=a1094cac7d016ffdbdaffa325ff5e0cf&tk=tt_chain_token&btag=e00088000" ], "Width": 720 }, "QualityType": 10, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 432411}, {\\\"time\\\": 2, \\\"offset\\\": 599887}, {\\\"time\\\": 3, \\\"offset\\\": 752883}, {\\\"time\\\": 4, \\\"offset\\\": 960464}, {\\\"time\\\": 5, \\\"offset\\\": 1279534}, {\\\"time\\\": 10, \\\"offset\\\": 2087308}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 88.754, \\\"v960\\\": 91.019, \\\"v864\\\": 92.23, \\\"v720\\\": 95.632}, \\\"ori\\\": {\\\"v1080\\\": 88.754, \\\"v960\\\": 91.019, \\\"v864\\\": 92.23, \\\"v720\\\": 95.632}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"65b88c41c0963253ad31b6f68981a242\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64215}" } ], "claInfo": { "enableAutoCaption": true, "hasOriginalAudio": true, "noCaptionReason": 3 }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=AeXHFNpadm77WV7WuEHFBTah28s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "720p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4qkVDaF1BfIvAFRtE3EBzYQGmEJAOfGDK8DEP/?a=1988&bti=ODszNWYuMDE6&&bt=1104&ft=-Csk_mH1PD12NZYPJn-UxHt5bY6e3wv25zcAp&mime_type=video_mp4&rc=PGk4OjQ3ZGc2MzdmNTY6OEBpanltO3A5cmdpZDMzaTczNEA0YDZfY2MyNi4xLTUxMDQyYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851268&l=202609061507007C0CF599064E4DE342E7&ply_type=2&policy=2&signature=393ad8e4c7ea5d3dea16a4e1ab7687b4&tk=tt_chain_token&btag=e00088000", "duration": 48, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=AeXHFNpadm77WV7WuEHFBTah28s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1280, "id": "7681719358225239326", "originCover": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oUSk82IQQQAqrYaeC5LU1gkvekVTfRAKGFeGDa~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=hkCCWTCSGPFYz9KlQZYLyYkbEIg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12NZYPJn-UxHt5bY6e3wv25zcAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851268&l=202609061507007C0CF599064E4DE342E7&ply_type=2&policy=2&signature=a1094cac7d016ffdbdaffa325ff5e0cf&tk=tt_chain_token&btag=e00088000", "ratio": "720p", "size": 7596593, "videoID": "v15044gf0000dadf5dfog65mh84jnv7g", "videoQuality": "normal", "volumeInfo": { "Loudness": -23.5, "Peak": 0.42658 }, "width": 720, "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=JTgDCxwrO1ZY1a9yoxXVSqR%2Fv%2BI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=4PZlOIHWxVBqUN2kTwOlT%2B1J7tE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=xfxMBBQ5hZ5ovkhw9th1WJWQWAc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=rUelNsgMB3uoXPjwGSZWaWmWi2k%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } }, "log_pb": { "impr_id": "202609061507007C0CF599064E4DE342E7" }, "shareMeta": { "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "title": "Khabane lame on TikTok" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/comments": { "get": { "tags": [ "Post" ], "summary": "Get Post Comments", "description": "Get top-level comments for a post.\n\nReturns comments[] (cid, text, digg_count, create_time,\nreply_comment_total, user), plus total/hasMore/cursor for\npagination.", "operationId": "getPostComments", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7681719358225239326", "example": "7681719358225239326" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "alias_comment_deleted": false, "comments": [ { "allow_download_photo": true, "author_pin": false, "aweme_id": "7681719358225239326", "cid": "7681818604698288914", "collect_stat": 0, "comment_language": "en", "comment_post_item_ids": null, "create_time": 1788562790, "digg_count": 969, "fold_status": -1, "forbid_reply_with_video": false, "image_list": [ { "crop_url": { "height": 1104, "uri": "tos-alisg-i-zt8igodiya-sg/f84c40fc1da9412f933529e515a46fd1", "url_list": [ "https://p16-comment-sign-sg.tiktokcdn.com/tos-alisg-i-zt8igodiya-sg/f84c40fc1da9412f933529e515a46fd1~tplv-jj85edgx6n-image-medium.image?dr=8569&refresh_token=7222702f&x-expires=1791270000&x-signature=W%2BcbJRm%2FaIYxy3IRYaeLJ25YB3I%3D&t=67a6c45e&ps=a0626fcd&shp=ff37627b&shcp=ff37627b&idc=my" ], "url_prefix": null, "width": 736 }, "origin_url": { "height": 1104, "uri": "tos-alisg-i-zt8igodiya-sg/f84c40fc1da9412f933529e515a46fd1", "url_list": [ "https://p16-comment-sign-sg.tiktokcdn.com/tos-alisg-i-zt8igodiya-sg/f84c40fc1da9412f933529e515a46fd1~tplv-jj85edgx6n-image-origin.image?dr=8569&refresh_token=428e8c15&x-expires=1791270000&x-signature=XX2onKvbd1ce%2B8nlaiZBUWd1rBY%3D&t=67a6c45e&ps=a0626fcd&shp=ff37627b&shcp=ff37627b&idc=my" ], "url_prefix": null, "width": 736 }, "source": 0 } ], "is_author_digged": false, "is_comment_translatable": true, "is_high_purchase_intent": false, "label_list": null, "no_show": false, "reply_comment": null, "reply_comment_total": 23, "reply_id": "0", "reply_to_reply_id": "0", "seeking_help_model_type": 0, "share_info": { "acl": { "add_to_story_code": 0, "code": 0, "extra": "{}" }, "desc": "HAM’s comment: THIS IS ONLY WAY", "title": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "url": "https://m.tiktok.com/v/7681719358225239326.html?_d=el402017iak894&comment_author_id=7557699321262687240&preview_pb=0&share_comment_id=7681818604698288914&share_item_id=7681719358225239326&sharer_language=en&source=h5_m&u_code=f1g8gj285eh8e8" }, "sort_extra_score": { "reply_score": 0.001331, "show_more_score": 0.027961 }, "sort_tags": "{\"fine_sort_main_queue\":1,\"rough_sort_main_queue\":1,\"top_list\":1}", "status": 1, "stick_position": 0, "text": "THIS IS ONLY WAY", "text_extra": [], "text_to_image_item_ids": null, "thread_has_more": false, "thread_id": 0, "trans_btn_style": 0, "translated_text_extra": null, "user": { "account_labels": null, "ad_cover_url": null, "advance_feature_item_order": null, "advanced_feature_info": null, "avatar_thumb": { "uri": "tos-alisg-avt-0068/aaed05d9a24e0f2d5db3b131f3e6a34a", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/aaed05d9a24e0f2d5db3b131f3e6a34a~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=43409b62&x-expires=1788764400&x-signature=rKtCNjZ1dtdz852Ul7hgKTNKVB4%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my" ], "url_prefix": null }, "bold_fields": null, "can_message_follow_status_list": null, "can_set_geofencing": null, "cha_list": null, "cover_url": null, "custom_verify": "", "enterprise_verify_reason": "", "events": null, "followers_detail": null, "geofencing": null, "homepage_bottom_toast": null, "item_list": null, "mutual_relation_avatars": null, "need_points": null, "nickname": "HAM", "platform_sync_info": null, "relative_users": null, "search_highlight": null, "sec_uid": "MS4wLjABAAAAw4p9Fv1Ey1xeXImaGfc7a7wnu08jzbbQbVC4IEmqU0gnWiw1qiGoujbhifDKz5oW", "shield_edit_field_info": null, "type_label": null, "uid": "7557699321262687240", "unique_id": "chief666o", "user_profile_guide": null, "user_tags": null, "white_cover_url": null }, "user_buried": false, "user_digged": 0 } ], "cursor": 5, "extra": { "api_debug_info": null, "fatal_item_ids": null, "now": 1788678421000 }, "has_filtered_comments": 0, "has_more": 1, "log_pb": { "impr_id": "2026090615070156085D388A05B36D0C5E" }, "reply_style": 2, "status_code": 0, "status_msg": "", "top_gifts": null, "total": 6854 } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/reply-comments": { "get": { "tags": [ "Post" ], "summary": "Get Comment Replies", "description": "Get replies to a specific comment (second-level comments).\n\nPass the parent comment's cid as commentId. Same pagination as\n/v1/post/comments.", "operationId": "getCommentReplies", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7681719358225239326", "example": "7681719358225239326" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." }, { "name": "commentId", "in": "query", "required": false, "schema": { "type": "string", "description": "Parent comment id - the cid field from GET /v1/post/comments.", "title": "Commentid", "default": "7681818604698288914", "example": "7681818604698288914" }, "description": "Parent comment id - the cid field from GET /v1/post/comments." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "comments": [ { "aweme_id": "7681719358225239326", "cid": "7681872831366267655", "collect_stat": 0, "comment_language": "en", "comment_post_item_ids": null, "create_time": 1788575616, "digg_count": 16, "fold_status": 0, "forbid_reply_with_video": false, "image_list": null, "is_author_digged": false, "is_comment_translatable": true, "is_high_purchase_intent": false, "label_list": null, "no_show": false, "reply_comment": null, "reply_id": "7681818604698288914", "reply_to_reply_id": "0", "seeking_help_model_type": 0, "share_info": { "acl": { "add_to_story_code": 1, "code": 1, "extra": "{\"is_share_handler_failed\":\"1\"}" }, "desc": "", "title": "", "url": "" }, "status": 1, "stick_position": 0, "text": "to hell yes", "text_extra": [], "text_to_image_item_ids": null, "thread_has_more": true, "thread_id": 1, "trans_btn_style": 0, "translated_text_extra": null, "user": { "account_labels": null, "ad_cover_url": null, "advance_feature_item_order": null, "advanced_feature_info": null, "avatar_thumb": { "uri": "tos-alisg-avt-0068/f3749f171405fb31b3fd25fc451202b7", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/f3749f171405fb31b3fd25fc451202b7~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=b5781ce9&x-expires=1788764400&x-signature=vXVRamwKKB7QD%2B%2FKmVvNV6Db7uk%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my" ], "url_prefix": null }, "bold_fields": null, "can_message_follow_status_list": null, "can_set_geofencing": null, "cha_list": null, "cover_url": null, "custom_verify": "", "enterprise_verify_reason": "", "events": null, "followers_detail": null, "geofencing": null, "homepage_bottom_toast": null, "item_list": null, "mutual_relation_avatars": null, "need_points": null, "nickname": "III", "platform_sync_info": null, "predicted_age_group": "4", "relative_users": null, "search_highlight": null, "sec_uid": "MS4wLjABAAAAkZyX6D9k1Q8-B3TgEtIZK_8P8Osl6t9mjMPDxLRfIZVtDFy4y851xr2A67nBq4IP", "shield_edit_field_info": null, "type_label": null, "uid": "7150823572066534406", "unique_id": "eftah5433et", "user_profile_guide": null, "user_tags": null, "white_cover_url": null }, "user_buried": false, "user_digged": 0 } ], "cursor": 5, "extra": { "fatal_item_ids": [], "logid": "202609061507027F40E3F1A013CCB3793F", "now": 1788678422000 }, "has_more": 1, "log_pb": { "impr_id": "202609061507027F40E3F1A013CCB3793F" }, "status_code": 0, "status_msg": "", "total": 23 } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/related": { "get": { "tags": [ "Post" ], "summary": "Get Related Posts", "description": "Get posts related to (recommended for) a given post.\n\nReturns itemList[] of recommended videos; the seed video itself is\nusually first. cursor pagination is limited server-side (~15 per\nseed) - for more, re-seed with an id from the previous page.", "operationId": "getRelatedPosts", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7681719358225239326", "example": "7681719358225239326" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "-1", "extra": { "fatal_item_ids": [], "logid": "20260906150702751DD5E066F7BDE64459", "now": 1788678423000 }, "itemList": [ { "AIGCDescription": "", "CategoryType": 104, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "127905465618821121", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Khabane lame", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "secret": false, "shortDramaCreator": {}, "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "stitchSetting": 0, "uniqueId": "khaby.lame", "verified": true }, "authorStats": { "diggCount": 6745, "followerCount": 162800000, "followingCount": 81, "friendCount": 0, "heart": 2700000000, "heartCount": -1594967296, "videoCount": 1351 }, "authorStatsV2": { "diggCount": "6745", "followerCount": "162800000", "followingCount": "81", "friendCount": "0", "heart": "2700000000", "heartCount": "2700000000", "videoCount": "1351" }, "backendSourceEventTracking": "yml_36", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "1697657584273413", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "learnfromkhaby" } ], "collected": false, "contents": [ { "desc": "I didn’t land well on my first jump… but at least I got to be here 🏊🏾#learnfromkhaby #comedy ", "textExtra": [ { "awemeId": "", "end": 86, "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 71, "subType": 0, "type": 1 } ] } ], "createTime": 1785171535, "desc": "I didn’t land well on my first jump… but at least I got to be here 🏊🏾#learnfromkhaby #comedy ", "digged": false, "diversificationId": 10003, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7667253313049546014", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Khabane lame", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 14, "id": "7667253282775649055", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oQDE5KDMFACRZHPeAJYkCBzU69TIIVAfAq4KJE/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThoVn~GXq8Zmo&mime_type=audio_mpeg&rc=MzQ6a3g5cm5yPDMzaTU8NEBpMzQ6a3g5cm5yPDMzaTU8NEA2ZzZyMmRjcGdhLS1kMTJzYSM2ZzZyMmRjcGdhLS1kMTJzcw%3D%3D&expire=1788682037&l=20260906150702751DD5E066F7BDE64459&ply_type=3&policy=3&signature=5d580ed6c959bceb7437548c21f27937&tk=7598066736076915733&btag=e00070000", "private": false, "shoot_duration": 14, "title": "original sound", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "arb_content_safety_status": 102, "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "ec_global_verdict": 1, "reviewed": 1, "status": 102, "tns_status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 33800, "commentCount": 7889, "diggCount": 956100, "playCount": 12300000, "shareCount": 10100 }, "statsV2": { "collectCount": "33783", "commentCount": "7889", "diggCount": "956100", "playCount": "12300000", "repostCount": "0", "shareCount": "10100" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 86, "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 71, "subType": 0, "type": 1 } ], "textLanguage": "en", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 4175544, "FileCs": "c:0-13443-6bc2", "FileHash": "fd55ea5ae049d304cc4afad9cfdb12f5", "Height": 1280, "Uri": "v15044gf0000d9jos5nog65q4a1snfug", "UrlKey": "v15044gf0000d9jos5nog65q4a1snfug_h264_720p_2317332", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o41I8julQioIqUzCfn6GeI6jwtALgexAHMQUIg/?a=1988&bti=ODszNWYuMDE6&&bt=2263&ft=-Csk_mH1PD12NuYPJn-UxuT5hY6e3wv25dcAp&mime_type=video_mp4&rc=ZTw4PDo1ZDxpNTYzaDM0ZkBpaml2ZHQ5cjhyPDMzaTczNEBhMGEtMy1iXjMxYS40Y18yYSNyay4xMmRrcGdhLS1kMTJzcw%3D%3D&expire=1788851237&l=20260906150702751DD5E066F7BDE64459&ply_type=2&policy=2&signature=53edffbb024aba758794a057b26024b2&tk=tt_chain_token&btag=e000b0000" ], "Width": 720 }, "VQScore": "65.8", "bitrate": 2317332, "bitrateInfo": [ { "Bitrate": 2317332, "BitrateFPS": 29, "CodecType": "h264", "Format": "mp4", "GearName": "normal_720_0", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 82.775, \"v960\": 86.682, \"v864\": 88.597, \"v720\": 91.574}, \"ori\": {\"v1080\": 82.775, \"v960\": 86.682, \"v864\": 88.597, \"v720\": 91.574}}}", "PlayAddr": { "DataSize": 4175544, "FileCs": "c:0-13443-6bc2", "FileHash": "fd55ea5ae049d304cc4afad9cfdb12f5", "Height": 1280, "Uri": "v15044gf0000d9jos5nog65q4a1snfug", "UrlKey": "v15044gf0000d9jos5nog65q4a1snfug_h264_720p_2317332", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o41I8julQioIqUzCfn6GeI6jwtALgexAHMQUIg/?a=1988&bti=ODszNWYuMDE6&&bt=2263&ft=-Csk_mH1PD12NuYPJn-UxuT5hY6e3wv25dcAp&mime_type=video_mp4&rc=ZTw4PDo1ZDxpNTYzaDM0ZkBpaml2ZHQ5cjhyPDMzaTczNEBhMGEtMy1iXjMxYS40Y18yYSNyay4xMmRrcGdhLS1kMTJzcw%3D%3D&expire=1788851237&l=20260906150702751DD5E066F7BDE64459&ply_type=2&policy=2&signature=53edffbb024aba758794a057b26024b2&tk=tt_chain_token&btag=e000b0000" ], "Width": 720 }, "QualityType": 10, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 261682}, {\\\"time\\\": 2, \\\"offset\\\": 624570}, {\\\"time\\\": 3, \\\"offset\\\": 896256}, {\\\"time\\\": 4, \\\"offset\\\": 1248708}, {\\\"time\\\": 5, \\\"offset\\\": 1619111}, {\\\"time\\\": 10, \\\"offset\\\": 3148134}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 82.775, \\\"v960\\\": 86.682, \\\"v864\\\": 88.597, \\\"v720\\\": 91.574}, \\\"ori\\\": {\\\"v1080\\\": 82.775, \\\"v960\\\": 86.682, \\\"v864\\\": 88.597, \\\"v720\\\": 91.574}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"65b88c41c0963253ad31b6f68981a242\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64832}" } ], "claInfo": { "enableAutoCaption": true, "hasOriginalAudio": true, "noCaptionReason": 3 }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocP6oLCjqGUDz8IwHA4gAfKuQeftilIIv5QXxR~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=0zKaah8cxO%2B5K9gPMG5qc131fYg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "720p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/owxiPjLlII6CqqMAvnlBvi9IOFAiQjeADZp1Eo/?a=1988&bti=ODszNWYuMDE6&&bt=2022&ft=-Csk_mH1PD12NuYPJn-UxuT5hY6e3wv25dcAp&mime_type=video_mp4&rc=NGRoaTg6OzVkNzdlNjNnO0Bpaml2ZHQ5cjhyPDMzaTczNEBfMC5iMDVjNV8xNDYuNWJjYSNyay4xMmRrcGdhLS1kMTJzcw%3D%3D&expire=1788851237&l=20260906150702751DD5E066F7BDE64459&ply_type=2&policy=2&signature=3598aa04880867c106d20e9ebc054b0b&tk=tt_chain_token&btag=e000b0000", "duration": 14, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o8DvoF9vI1iSxqiCAPBnLOiemlbMAA6IIUjRIC~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=O%2Fb69%2FqaPW106joOvqT2T3YsGPE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1280, "id": "7667253313049546014", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/okPnO1oIiKheAiCNLBqIDAij2FvMA9B6CIlvIv~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=FCcg38RyJQmY1rjP7DGu7hZiDSQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o41I8julQioIqUzCfn6GeI6jwtALgexAHMQUIg/?a=1988&bti=ODszNWYuMDE6&&bt=2263&ft=-Csk_mH1PD12NuYPJn-UxuT5hY6e3wv25dcAp&mime_type=video_mp4&rc=ZTw4PDo1ZDxpNTYzaDM0ZkBpaml2ZHQ5cjhyPDMzaTczNEBhMGEtMy1iXjMxYS40Y18yYSNyay4xMmRrcGdhLS1kMTJzcw%3D%3D&expire=1788851237&l=20260906150702751DD5E066F7BDE64459&ply_type=2&policy=2&signature=53edffbb024aba758794a057b26024b2&tk=tt_chain_token&btag=e000b0000", "ratio": "720p", "size": 4175544, "videoID": "v15044gf0000d9jos5nog65q4a1snfug", "videoQuality": "normal", "volumeInfo": { "Loudness": -35.6, "Peak": 0.27227 }, "width": 720, "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocP6oLCjqGUDz8IwHA4gAfKuQeftilIIv5QXxR~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1788850800&x-signature=OT0pniOBZ0y0TmEoW2aYi%2FgifVk%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocP6oLCjqGUDz8IwHA4gAfKuQeftilIIv5QXxR~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1788850800&x-signature=dcibIFDItHCA8fOuQ7QmBdCD4ks%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocP6oLCjqGUDz8IwHA4gAfKuQeftilIIv5QXxR~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1788850800&x-signature=SIXPjkSnqBroJrl7ZTCNBTWgxyc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocP6oLCjqGUDz8IwHA4gAfKuQeftilIIv5QXxR~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1788850800&x-signature=tK07YxvMhEDjkf5BFLQWiEKSQfY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "20260906150702751DD5E066F7BDE64459" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/subtitles": { "get": { "tags": [ "Post" ], "summary": "Get Post Subtitles", "description": "Get subtitle (auto-caption) tracks for a post.\n\nReturns subtitleInfos[]: language, format (webvtt), size, source\n(MT = machine-translated), and a temporary download URL per track.\nSilent videos return an empty list. URLs expire after a few hours.", "operationId": "getPostSubtitles", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7666448128882625805", "example": "7666448128882625805" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "video_id": "7666448128882625805", "count": 1, "subtitles": [ { "language": "eng-US", "format": "webvtt", "url": "https://v16-webapp.tiktok.com/a9e3c66eefb0203ed8deed587c4a4de6/6a9fbcfa/video/tos/alisg/tos-alisg-v-37c799-sg/7c064766470a43e79d86fc62823e112b/?a=1988&bti=ODszNWYuMDE6&&bt=1369&ft=-ElcomH1PD12NUcPJn-UxvV5hY6e3wv252cAp&mime_type=video_mp4&rc=M21mNnM5cjxkPDMzZzczNEBpM21mNnM5cjxkPDMzZzczNEBobTRyMmRzb2ZhLS1kMS9zYSNobTRyMmRzb2ZhLS1kMS9zcw%3D%3D&l=2026090615081234894B9D97CA74C2561E&btag=e00068000", "size": 45833, "auto_caption": false, "source": "ASR" } ] } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/transcript": { "get": { "tags": [ "Post" ], "summary": "Get Post Transcript", "description": "Get a ready-to-use transcript for a post (plain text by default).\n\nDownloads the auto-caption track and parses it: plain text, or\n\"[mm:ss] text\" lines when withTimestamps=true. Pick a track\nexplicitly with language (e.g. \"en\", \"vi\"), otherwise the first\navailable track is used.", "operationId": "getPostTranscript", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7666448128882625805", "example": "7666448128882625805" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." }, { "name": "language", "in": "query", "required": false, "schema": { "description": "Caption track language code, e.g. \"en\" / \"eng-US\". Default: first available track.", "title": "Language", "type": "string", "default": "eng-US", "example": "eng-US" }, "description": "Caption track language code, e.g. \"en\" / \"eng-US\". Default: first available track." }, { "name": "withTimestamps", "in": "query", "required": false, "schema": { "type": "boolean", "description": "true = prefix each line with [mm:ss] timestamps.", "default": false, "title": "Withtimestamps" }, "description": "true = prefix each line with [mm:ss] timestamps." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "video_id": "7666448128882625805", "language": "eng-US", "auto_caption": false, "text": "If you know these 30 words,\nyour English is excellent.\nThese are words that native speakers use\nto sound educated and professional.\nDo you know them? Can you use them?\nLet's find out if your English vocabulary is advanced.\nWelcome back to J First English.\nOf course. I'm Jennifer.\nNow, let's get started.\nThe first word is mingle.\nMingle. Do you know what this means?\nUnderstanding meaning depends on...(truncated)" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/post/subtitle-file": { "get": { "tags": [ "Post" ], "summary": "Get Post Subtitle File", "description": "Download a post's caption track via the gateway, raw WebVTT.\n\nUnparsed (millisecond cue timings kept) for players and subtitle\ntools. Same track selection as /v1/post/transcript: language\npicks a track (e.g. \"eng-US\"), default = first. The gateway's\negress does the CDN fetch, so callers never hit anti-bot 403s\nor expiring signed URLs.", "operationId": "getPostSubtitleFile", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL.", "title": "Videoid", "default": "7666448128882625805", "example": "7666448128882625805" }, "description": "Numeric video id - itemList[].id from a posts endpoint, or the number in a tiktok.com/@user/video/ URL." }, { "name": "language", "in": "query", "required": false, "schema": { "description": "Caption track language code, e.g. \"eng-US\". Default: first available track.", "title": "Language", "type": "string", "default": "eng-US", "example": "eng-US" }, "description": "Caption track language code, e.g. \"eng-US\". Default: first available track." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "video_id": "7666448128882625805", "language": "eng-US", "format": "webvtt", "auto_caption": false, "source": "ASR", "vtt": "WEBVTT\n\n\n00:00:00.020 --> 00:00:02.900\nIf you know these 30 words,\n\n00:00:02.901 --> 00:00:05.281\nyour English is excellent.\n\n00:00:05.420 --> 00:00:07.660\nThese are words that native speakers use\n\n00:00:07.661 --> 00:00:10.241\nto sound educated and professional.\n\n00:00:10.340 --> 00:00:12.780\nDo you know them? Can you use them?\n\n00:00:12.781 --> 00:00:16.761\nLet's find out if your English vocabul...(truncated)" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/challenge/info": { "get": { "tags": [ "Challenge" ], "summary": "Get Challenge Info", "description": "Get hashtag (challenge) info by name.\n\nPass the tag without the # (e.g. hashtag=fyp). Returns challengeInfo:\nid (numeric challengeId), title, desc, cover, and stats\n(viewCount, userCount, videoCount).", "operationId": "getChallengeInfo", "parameters": [ { "name": "hashtag", "in": "query", "required": false, "schema": { "type": "string", "description": "Hashtag name without the # sign, e.g. fyp.", "title": "Hashtag", "default": "fyp", "example": "fyp" }, "description": "Hashtag name without the # sign, e.g. fyp." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "challengeInfo": { "challenge": { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "229207", "isCommerce": false, "profileLarger": "", "profileMedium": "", "profileThumb": "", "stats": { "videoCount": 0, "viewCount": 127406000000000 }, "title": "fyp" }, "challengeAnnouncement": { "body": "", "title": "" }, "stats": { "videoCount": 0, "viewCount": 127406000000000 }, "statsV2": { "videoCount": "9243014177", "viewCount": "127405999401582" } }, "extra": { "fatal_item_ids": [], "logid": "202609061507077AF84D00AC58C8DAB606", "now": 1788678427000 }, "log_pb": { "impr_id": "202609061507077AF84D00AC58C8DAB606" }, "shareMeta": { "desc": "Watch awesome short videos created with trending hashtag #fyp", "title": "#fyp on TikTok" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/challenge/posts": { "get": { "tags": [ "Challenge" ], "summary": "Get Challenge Posts", "description": "Get posts using a hashtag (challenge).\n\nUse the numeric challengeId from /v1/challenge/info. Returns\nitemList[] with cursor/hasMore pagination.", "operationId": "getChallengePosts", "parameters": [ { "name": "challengeId", "in": "query", "required": false, "schema": { "type": "string", "description": "Numeric challenge (hashtag) id - resolve a tag name via GET /v1/challenge/info.", "title": "Challengeid", "default": "229207", "example": "229207" }, "description": "Numeric challenge (hashtag) id - resolve a tag name via GET /v1/challenge/info." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "15", "extra": { "fatal_item_ids": [], "logid": "20260906150707A80478B55A9BE6857F2C", "now": 1788678428000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 111, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/d9ab3fcc591559c96e84aa66b57731dd~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=f3e9a36f&x-expires=1788850800&x-signature=NU3ReCMgp%2FEcnyMge1Y0uFBl2%2FM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/d9ab3fcc591559c96e84aa66b57731dd~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=346adb09&x-expires=1788850800&x-signature=6tzwNip6hE0Mnaz9c%2BDceZhZ%2FTU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/d9ab3fcc591559c96e84aa66b57731dd~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=30e88ae2&x-expires=1788850800&x-signature=4gYuKvWNkem%2BhMzxHmo04n0c7No%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "6976937168171336706", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Mara Lazeez | مره لذيذ", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAA_ykDfR3ZUs3Mp1nMxgLNopQVxjXN54zE9pcZre3DoTUWizd6VayveAVoFnn9mul0", "secret": false, "shortDramaCreator": {}, "signature": "وصفات عربية خليجية، برامج مسلية، أبو لقمة 🎤💬!\nhttps://linktr.ee/mara.lazeez", "stitchSetting": 0, "uniqueId": "mara.lazeez", "verified": true }, "authorStats": { "diggCount": 230, "followerCount": 663100, "followingCount": 9, "friendCount": 0, "heart": 1900000, "heartCount": 1900000, "videoCount": 1190 }, "authorStatsV2": { "diggCount": "230", "followerCount": "663100", "followingCount": "9", "friendCount": "0", "heart": "1900000", "heartCount": "1900000", "videoCount": "1190" }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/21ab096c8b628871020d5b8a770b8599.jpeg~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=8FgpX1qsPAm07gK97l1mmwlnDqY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/21ab096c8b628871020d5b8a770b8599.jpeg~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=8FgpX1qsPAm07gK97l1mmwlnDqY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/21ab096c8b628871020d5b8a770b8599.jpeg~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=8FgpX1qsPAm07gK97l1mmwlnDqY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "desc": "!لكل محبّي الطعام، استعدوا لتحضير أسهل وألذ الوصفات", "id": "1625374032699398", "profileLarger": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/dae5c1c4e8f093f6ab7054c8cadff038.jpeg~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=kRKp4IqxczEF6bfhWnASfwFcNeE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "profileMedium": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/dae5c1c4e8f093f6ab7054c8cadff038.jpeg~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=kRKp4IqxczEF6bfhWnASfwFcNeE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "profileThumb": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/dae5c1c4e8f093f6ab7054c8cadff038.jpeg~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=kRKp4IqxczEF6bfhWnASfwFcNeE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "title": "شي_طيب" } ], "collected": false, "contents": [ { "desc": "بسكويت ولا اطيب 🍪😍 #شي_طيب #حلويات #foodie #foodart #cookies #TikTokCookBook #instafood", "textExtra": [ { "awemeId": "", "end": 28, "hashtagName": "شي_طيب", "isCommerce": false, "start": 21, "subType": 0, "type": 1 } ] } ], "createTime": 1647458085, "desc": "بسكويت ولا اطيب 🍪😍 #شي_طيب #حلويات #foodie #foodart #cookies #TikTokCookBook #instafood", "digged": false, "diversificationId": 10040, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7075778590062988546", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "album": "Takke", "authorName": "Nassif Zeytoun", "coverLarge": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/626d41ddf0ed436f8a9e78af6cdefea3.jpeg", "coverMedium": "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/626d41ddf0ed436f8a9e78af6cdefea3.jpeg", "coverThumb": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/626d41ddf0ed436f8a9e78af6cdefea3.jpeg", "duration": 60, "id": "6870193640413612033", "isCopyrighted": false, "is_commerce_music": false, "is_unlimited_music": false, "original": false, "playUrl": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oEqsR1UDhuZxOUPI0BejC99ngeQa1BEcbPbtBK", "private": false, "shoot_duration": 60, "title": "Takke", "tt2dsp": { "tt_to_dsp_song_infos": [ { "meta_song_id": "6870193636642916354", "platform": 1, "song_id": "1566783504", "token": { "apple_music_token": { "developer_token": "eyJhbGciOiJFUzI1NiIsImtpZCI6Ikc2Q0dLMjdWQzMifQ.eyJleHAiOjE3ODg4NzgwNDUsImlhdCI6MTc4ODYxODg0NSwiaXNzIjoiTUo3OTdEOFU2RiJ9.b0LgZqZT7UBeUQTXMdY07uVsx-ryih_3D-JX7_yN8tOoYdHvzmQoXKVJn8UNzJCmYBJcDFfmckWjsqPN5XI8dQ" } } } ] } }, "officalItem": false, "originalItem": false, "penaltyContext": { "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 1419, "commentCount": 297, "diggCount": 25200, "playCount": 1200000, "shareCount": 524 }, "statsV2": { "collectCount": "1419", "commentCount": "297", "diggCount": "25200", "playCount": "1200000", "repostCount": "0", "shareCount": "524" }, "stickersOnItem": [ { "stickerText": [ "بسكويت بالمارشمالو 🍪😍" ], "stickerType": 4 } ], "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 28, "hashtagName": "شي_طيب", "isCommerce": false, "start": 21, "subType": 0, "type": 1 } ], "textLanguage": "ar", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 1053652, "FileCs": "c:0-11799-10ac", "FileHash": "46c703cc74876926737b77890dba7673", "Height": 1024, "Uri": "v10044g50000c8p3d3bc77u8gi82bg5g", "UrlKey": "v10044g50000c8p3d3bc77u8gi82bg5g_h264_540p_617434", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/97f69bb7c2c64a959eeeae341caebe5b/?a=1988&bti=ODszNWYuMDE6&&bt=602&ft=I~da4o62D12NvxlDEzIxRhONblBF-UjNSmopiX&mime_type=video_mp4&rc=M2dnNmU5Z2c1M2k7OTc2PEBpamo1bDs6ZjY2OzMzODczNEBfNjYtNDAzX14xMmIxXmBgYSMyXzVkcjRfYW1gLS1kMS1zcw%3D%3D&expire=1788851241&l=20260906150707A80478B55A9BE6857F2C&ply_type=2&policy=2&signature=e52da3f23a5e0bea5d574282963adbf4&tk=tt_chain_token&btag=e00070000" ], "Width": 576 }, "VQScore": "65.8", "bitrate": 617434, "bitrateInfo": [ { "Bitrate": 617434, "BitrateFPS": 30, "CodecType": "h264", "Format": "mp4", "GearName": "normal_540_0", "MVMAF": "", "PlayAddr": { "DataSize": 1053652, "FileCs": "c:0-11799-10ac", "FileHash": "46c703cc74876926737b77890dba7673", "Height": 1024, "Uri": "v10044g50000c8p3d3bc77u8gi82bg5g", "UrlKey": "v10044g50000c8p3d3bc77u8gi82bg5g_h264_540p_617434", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/97f69bb7c2c64a959eeeae341caebe5b/?a=1988&bti=ODszNWYuMDE6&&bt=602&ft=I~da4o62D12NvxlDEzIxRhONblBF-UjNSmopiX&mime_type=video_mp4&rc=M2dnNmU5Z2c1M2k7OTc2PEBpamo1bDs6ZjY2OzMzODczNEBfNjYtNDAzX14xMmIxXmBgYSMyXzVkcjRfYW1gLS1kMS1zcw%3D%3D&expire=1788851241&l=20260906150707A80478B55A9BE6857F2C&ply_type=2&policy=2&signature=e52da3f23a5e0bea5d574282963adbf4&tk=tt_chain_token&btag=e00070000" ], "Width": 576 }, "QualityType": 20, "VideoExtra": "{\"PktOffsetMap\":\"\",\"mvmaf\":\"\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":32160}" } ], "claInfo": { "enableAutoCaption": true, "hasOriginalAudio": true, "noCaptionReason": 3 }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/077d75412fc848f590d1c195471172fa_1647458088~tplv-tiktokx-dmt-logom:tos-alisg-i-0000/1bdb3f59a77e4098ae6c5312abe16cdf.image?dr=14573&x-expires=1788850800&x-signature=64PkWdb5hJnXpAQu0IFK5WHCjkI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "540p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/66a3e8ecde72478087bfce0f0498143d/?a=1988&bti=ODszNWYuMDE6&&bt=634&ft=I~da4o62D12NvxlDEzIxRhONblBF-UjNSmopiX&mime_type=video_mp4&rc=NGRnNmVmZzM6PDxkZ2hnZEBpamo1bDs6ZjY2OzMzODczNEAzY2AyXzYyXzMxMjMxYTNiYSMyXzVkcjRfYW1gLS1kMS1zcw%3D%3D&expire=1788851241&l=20260906150707A80478B55A9BE6857F2C&ply_type=2&policy=2&signature=8f9075fba46524f5b071f3014dd81468&tk=tt_chain_token&btag=e00070000", "duration": 13, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/aeff05224cd04815a8b8e230e815d7bb_1647458087~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=Utqmtd8lih6XFd2dU0P6Mh5ZLBQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1024, "id": "7075778590062988546", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/61a5115a769f436db60dca29daa98e7a_1647458086~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=fyKmuZuyv2iec7MIiQP6QihlveE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/97f69bb7c2c64a959eeeae341caebe5b/?a=1988&bti=ODszNWYuMDE6&&bt=602&ft=I~da4o62D12NvxlDEzIxRhONblBF-UjNSmopiX&mime_type=video_mp4&rc=M2dnNmU5Z2c1M2k7OTc2PEBpamo1bDs6ZjY2OzMzODczNEBfNjYtNDAzX14xMmIxXmBgYSMyXzVkcjRfYW1gLS1kMS1zcw%3D%3D&expire=1788851241&l=20260906150707A80478B55A9BE6857F2C&ply_type=2&policy=2&signature=e52da3f23a5e0bea5d574282963adbf4&tk=tt_chain_token&btag=e00070000", "ratio": "540p", "size": 1053652, "videoID": "v10044g50000c8p3d3bc77u8gi82bg5g", "videoQuality": "normal", "volumeInfo": { "Loudness": -10.8, "Peak": 1 }, "width": 576, "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/077d75412fc848f590d1c195471172fa_1647458088~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=QOuJPK%2FYZHRBJwOp56GzYN%2BCvJQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/077d75412fc848f590d1c195471172fa_1647458088~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=UT8hXemeqSdjKhbPAgVEEuiXlvg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/077d75412fc848f590d1c195471172fa_1647458088~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=0KvIFAinm93G0kD6YvdW8uXkW3Q%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/077d75412fc848f590d1c195471172fa_1647458088~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=2Z8CEL8GJXoPKs742%2B2l4kfpL2I%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "20260906150707A80478B55A9BE6857F2C" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/music/info": { "get": { "tags": [ "Music" ], "summary": "Get Music Info", "description": "Get music track info by ID.\n\nReturns the music object: title, author, album, cover, duration,\nplayCount, and original flag.", "operationId": "getMusicInfo", "parameters": [ { "name": "musicId", "in": "query", "required": false, "schema": { "type": "string", "description": "Music id - the music.id field of any post object.", "title": "Musicid", "default": "127905465618821121", "example": "127905465618821121" }, "description": "Music id - the music.id field of any post object." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "extra": { "fatal_item_ids": [], "logid": "20260906150709096FA7DBBA9868B5337E", "now": 1788678429000 }, "log_pb": { "impr_id": "20260906150709096FA7DBBA9868B5337E" }, "musicInfo": { "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "ftc": false, "id": "127905465618821121", "nickname": "Khabane lame", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "secret": false, "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "uniqueId": "khaby.lame" }, "music": { "authorName": "Khabane lame", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 48, "id": "7681719448159619870", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oQEaap8Aiv8irZBEA3vGRClCzAoRAJuzaytAV/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7Th7Vn~GXq8Zmo&mime_type=audio_mpeg&rc=Mzt4dnE5cjxpZDMzaTU8NEBpMzt4dnE5cjxpZDMzaTU8NEAwb3E1MmRrM2FhLS1kMTJzYSMwb3E1MmRrM2FhLS1kMTJzcw%3D%3D&vvpl=1&l=20260906150709096FA7DBBA9868B5337E&VExpiration=1788764877&VSignature=pJw5diudKSaYqnddVWCR3w&btag=e00048000&sp_exp=hash_v0", "private": false, "shoot_duration": 48, "title": "original sound", "tt2dsp": {} }, "stats": { "videoCount": 20 } }, "shareMeta": { "desc": "20 videos - Watch awesome short videos created with ♬ original sound", "title": "khaby.lame | ♬ original sound | on TikTok" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/music/posts": { "get": { "tags": [ "Music" ], "summary": "Get Music Posts", "description": "Get posts using a music track.\n\nUse the musicId from any post's music object. Returns itemList[]\nwith cursor/hasMore pagination.", "operationId": "getMusicPosts", "parameters": [ { "name": "musicId", "in": "query", "required": false, "schema": { "type": "string", "description": "Music id - the music.id field of any post object.", "title": "Musicid", "default": "127905465618821121", "example": "127905465618821121" }, "description": "Music id - the music.id field of any post object." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "5", "extra": { "fatal_item_ids": [], "logid": "2026090615070959C840CA56B600E068D3", "now": 1788678429000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 104, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "127905465618821121", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Khabane lame", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA", "secret": false, "shortDramaCreator": {}, "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎", "stitchSetting": 0, "uniqueId": "khaby.lame", "verified": true }, "authorStats": { "diggCount": 6745, "followerCount": 162800000, "followingCount": 81, "friendCount": 0, "heart": 2700000000, "heartCount": -1594967296, "videoCount": 1351 }, "authorStatsV2": { "diggCount": "6745", "followerCount": "162800000", "followingCount": "81", "friendCount": "0", "heart": "2700000000", "heartCount": "2700000000", "videoCount": "1351" }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "1697657584273413", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "learnfromkhaby" } ], "collected": false, "contents": [ { "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "textExtra": [ { "awemeId": "", "end": 47, "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 32, "subType": 0, "type": 1 } ] } ], "createTime": 1788539684, "desc": "Well… that didn’t go as planned #learnfromkhaby #comedy ", "digged": false, "diversificationId": 10000, "duetDisplay": 0, "duetEnabled": true, "effectStickers": [ { "ID": "2006694775", "name": "slideshow", "stickerStats": { "useCount": 0 } } ], "forFriend": false, "id": "7681719358225239326", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Khabane lame", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=840eb146&x-expires=1788850800&x-signature=VOs4R6tbWQWEnNg5KRZNfgTZOcs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0af26583&x-expires=1788850800&x-signature=wNcoNKM0f6Z38EQH54cbLS%2BkNno%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9003d58e&x-expires=1788850800&x-signature=B30PWNktyXTgyYAVokpo09yWhrQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 48, "id": "7681719448159619870", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oQEaap8Aiv8irZBEA3vGRClCzAoRAJuzaytAV/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7Th7Vn~GXq8Zmo&mime_type=audio_mpeg&rc=Mzt4dnE5cjxpZDMzaTU8NEBpMzt4dnE5cjxpZDMzaTU8NEAwb3E1MmRrM2FhLS1kMTJzYSMwb3E1MmRrM2FhLS1kMTJzcw%3D%3D&vvpl=1&l=2026090615070959C840CA56B600E068D3&VExpiration=1788764877&VSignature=pJw5diudKSaYqnddVWCR3w&btag=e00048000&sp_exp=hash_v0", "private": false, "shoot_duration": 48, "title": "original sound", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "arb_content_safety_status": 102, "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "ec_global_verdict": 6, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 12600, "commentCount": 6854, "diggCount": 303900, "playCount": 2200000, "shareCount": 5127 }, "statsV2": { "collectCount": "12615", "commentCount": "6854", "diggCount": "303900", "playCount": "2200000", "repostCount": "0", "shareCount": "5127" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 47, "hashtagName": "learnfromkhaby", "isCommerce": false, "start": 32, "subType": 0, "type": 1 } ], "textLanguage": "en", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 7596593, "FileCs": "c:0-30965-742b", "FileHash": "a4037025357a0bea245ef79e7efb3a45", "Height": 1280, "Uri": "v15044gf0000dadf5dfog65mh84jnv7g", "UrlKey": "v15044gf0000dadf5dfog65mh84jnv7g_h264_720p_1248566", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12N1YPJn-Ux342hY6e3wv25xcAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851277&l=2026090615070959C840CA56B600E068D3&ply_type=2&policy=2&signature=7a7039ec12e20bf61413f389a3538c4a&tk=tt_chain_token&btag=e00088000" ], "Width": 720 }, "VQScore": "64.89", "bitrate": 1248566, "bitrateInfo": [ { "Bitrate": 1248566, "BitrateFPS": 23, "CodecType": "h264", "Format": "mp4", "GearName": "normal_720_0", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 88.754, \"v960\": 91.019, \"v864\": 92.23, \"v720\": 95.632}, \"ori\": {\"v1080\": 88.754, \"v960\": 91.019, \"v864\": 92.23, \"v720\": 95.632}}}", "PlayAddr": { "DataSize": 7596593, "FileCs": "c:0-30965-742b", "FileHash": "a4037025357a0bea245ef79e7efb3a45", "Height": 1280, "Uri": "v15044gf0000dadf5dfog65mh84jnv7g", "UrlKey": "v15044gf0000dadf5dfog65mh84jnv7g_h264_720p_1248566", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12N1YPJn-Ux342hY6e3wv25xcAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851277&l=2026090615070959C840CA56B600E068D3&ply_type=2&policy=2&signature=7a7039ec12e20bf61413f389a3538c4a&tk=tt_chain_token&btag=e00088000" ], "Width": 720 }, "QualityType": 10, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 432411}, {\\\"time\\\": 2, \\\"offset\\\": 599887}, {\\\"time\\\": 3, \\\"offset\\\": 752883}, {\\\"time\\\": 4, \\\"offset\\\": 960464}, {\\\"time\\\": 5, \\\"offset\\\": 1279534}, {\\\"time\\\": 10, \\\"offset\\\": 2087308}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 88.754, \\\"v960\\\": 91.019, \\\"v864\\\": 92.23, \\\"v720\\\": 95.632}, \\\"ori\\\": {\\\"v1080\\\": 88.754, \\\"v960\\\": 91.019, \\\"v864\\\": 92.23, \\\"v720\\\": 95.632}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"65b88c41c0963253ad31b6f68981a242\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64215}" } ], "claInfo": { "enableAutoCaption": true, "hasOriginalAudio": true, "noCaptionReason": 3 }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=AeXHFNpadm77WV7WuEHFBTah28s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "720p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4qkVDaF1BfIvAFRtE3EBzYQGmEJAOfGDK8DEP/?a=1988&bti=ODszNWYuMDE6&&bt=1104&ft=-Csk_mH1PD12N1YPJn-Ux342hY6e3wv25xcAp&mime_type=video_mp4&rc=PGk4OjQ3ZGc2MzdmNTY6OEBpanltO3A5cmdpZDMzaTczNEA0YDZfY2MyNi4xLTUxMDQyYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851277&l=2026090615070959C840CA56B600E068D3&ply_type=2&policy=2&signature=34b8d96ee8ae1be2cd45bc75d5439fed&tk=tt_chain_token&btag=e00088000", "duration": 48, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=AeXHFNpadm77WV7WuEHFBTah28s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1280, "id": "7681719358225239326", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oUSk82IQQQAqrYaeC5LU1gkvekVTfRAKGFeGDa~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=Wn9UnZ0EsfFDeRkqXKb86%2FRSsfU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooEBHqvBF3KEEjFRmfEQQ1AVJ8AfP1taPqmIzD/?a=1988&bti=ODszNWYuMDE6&&bt=1219&ft=-Csk_mH1PD12N1YPJn-Ux342hY6e3wv25xcAp&mime_type=video_mp4&rc=ZGZmPDhpZ2U3aTgzMzhoNkBpanltO3A5cmdpZDMzaTczNEAtNS1iNF41X2AxL2MxXi1gYSM0azFlMmRjMmFhLS1kMTJzcw%3D%3D&expire=1788851277&l=2026090615070959C840CA56B600E068D3&ply_type=2&policy=2&signature=7a7039ec12e20bf61413f389a3538c4a&tk=tt_chain_token&btag=e00088000", "ratio": "720p", "size": 7596593, "videoID": "v15044gf0000dadf5dfog65mh84jnv7g", "videoQuality": "normal", "volumeInfo": { "Loudness": -23.5, "Peak": 0.42658 }, "width": 720, "zoomCover": { "240": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=AAOzY0gLYgT0PXE%2FZw8cJJXAdvA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=4PZlOIHWxVBqUN2kTwOlT%2B1J7tE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=xfxMBBQ5hZ5ovkhw9th1WJWQWAc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocklIYFbAlVjfsD1EADAQMmzRZqA5CEEAvEcfg~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=rUelNsgMB3uoXPjwGSZWaWmWi2k%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "2026090615070959C840CA56B600E068D3" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/collection/detail": { "get": { "tags": [ "Collection" ], "summary": "Get Collection Detail", "description": "Get collection (playlist / mix) detail by ID.\n\nReturns collection info: title, cover, video count, and the\ncreator's user object.", "operationId": "getCollectionDetail", "parameters": [ { "name": "collectionId", "in": "query", "required": false, "schema": { "type": "string", "description": "Collection id - the id field from GET /v1/user/playlists.", "title": "Collectionid", "default": "7637624139910220558", "example": "7637624139910220558" }, "description": "Collection id - the id field from GET /v1/user/playlists." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "extra": { "fatal_item_ids": [], "logid": "2026090615082135E9ACA291A15CBD3C08", "now": 1788678501000 }, "log_pb": { "impr_id": "2026090615082135E9ACA291A15CBD3C08" }, "mixInfo": { "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-tiktokx-origin.image?dr=14575&x-expires=1788699600&x-signature=zM7U9LvKgquuGUaAcZqG9zGxxQA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "creator": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=fec24ece&x-expires=1788850800&x-signature=hARtu0GPwapJPUCfrS3UMyoKv30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=cd0302a5&x-expires=1788850800&x-signature=soDXZ%2BtRy6kIIKKvYhoEEPK9CsA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6487337b&x-expires=1788850800&x-signature=dw7peZrEd560d7uTLUnVobSf9hs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "ftc": false, "id": "7265646866401821738", "isADVirtual": false, "nickname": "dadsfoodtoday", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAA7eCJ5F6pZzNzwgPvWw5rr1Y5MftaETOsftKGVDBoECj7im34SxXX6Kl3eG9FUlyb", "secret": false, "shortDramaCreator": {}, "signature": "Ben Decocker | NY 🇺🇸\nDad of 4 hungry boys\nQuick & Easy Family Meals \n👇 Get the full recipes", "uniqueId": "dadsfoodtoday", "verified": false }, "id": "7637624139910220558", "name": "Dinners 🔥", "videoCount": 9 }, "shareMeta": { "desc": "TikTok: Make Every Second Count", "title": "Join TikTok and see what I've been up to!" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/collection/posts": { "get": { "tags": [ "Collection" ], "summary": "Get Collection Posts", "description": "Get the posts inside a collection (playlist / mix).\n\nReturns itemList[] in playlist order with cursor/hasMore\npagination.", "operationId": "getCollectionPosts", "parameters": [ { "name": "collectionId", "in": "query", "required": false, "schema": { "type": "string", "description": "Collection id - the id field from GET /v1/user/playlists.", "title": "Collectionid", "default": "7637624139910220558", "example": "7637624139910220558" }, "description": "Collection id - the id field from GET /v1/user/playlists." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "5", "extra": { "fatal_item_ids": [], "logid": "20260906150821E6B432A1BD2A28C99007", "now": 1788678502000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 111, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=fec24ece&x-expires=1788850800&x-signature=hARtu0GPwapJPUCfrS3UMyoKv30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=cd0302a5&x-expires=1788850800&x-signature=soDXZ%2BtRy6kIIKKvYhoEEPK9CsA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6487337b&x-expires=1788850800&x-signature=dw7peZrEd560d7uTLUnVobSf9hs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "7265646866401821738", "isADVirtual": false, "isEmbedBanned": false, "nickname": "dadsfoodtoday", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAA7eCJ5F6pZzNzwgPvWw5rr1Y5MftaETOsftKGVDBoECj7im34SxXX6Kl3eG9FUlyb", "secret": false, "shortDramaCreator": {}, "signature": "Ben Decocker | NY 🇺🇸\nDad of 4 hungry boys\nQuick & Easy Family Meals \n👇 Get the full recipes", "stitchSetting": 0, "uniqueId": "dadsfoodtoday", "verified": false }, "authorStats": { "diggCount": 488, "followerCount": 51900, "followingCount": 61, "friendCount": 0, "heart": 1800000, "heartCount": 1800000, "videoCount": 175 }, "authorStatsV2": { "diggCount": "488", "followerCount": "51900", "followingCount": "61", "friendCount": "0", "heart": "1800000", "heartCount": "1800000", "videoCount": "175" }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "13532", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "chicken" } ], "collected": false, "contents": [ { "desc": "Hands down the best Creamy Pesto Chicken pasta!!! " } ], "createTime": 1778251033, "desc": "Hands down the best Creamy Pesto Chicken pasta!!! Serves: 2-4 Ingredients Chicken 2 chicken breasts 1 tbsp olive oil 1 tbsp butter 2 tbsp chicken bouillon 1 tsp chili flakes Juice of 1 lime 1 tsp Italian seasoning 2 tsp black pepper 1 tbsp smoked paprika 5 cloves garlic, minced 1 onion, chopped Pasta & Sauce 255 g gluten-free tagliatelle or pasta of choice 3 cups heavy cream 4 tbsp pesto 1/2 cup ...(truncated)", "digged": false, "diversificationId": 10040, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7637529980162805006", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "album": "Out of the Blue", "authorName": "Electric Light Orchestra", "coverLarge": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oIAqeRU8MeQlFAMVK5MfOGW0AMOfAVeI1joAIr.jpeg", "coverMedium": "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oIAqeRU8MeQlFAMVK5MfOGW0AMOfAVeI1joAIr.jpeg", "coverThumb": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/oIAqeRU8MeQlFAMVK5MfOGW0AMOfAVeI1joAIr.jpeg", "duration": 33, "id": "6754420279457565445", "isCopyrighted": true, "is_commerce_music": false, "is_unlimited_music": false, "original": false, "playUrl": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/b6210191f1854b7c9157d5d1e2e5fe77", "private": false, "shoot_duration": 33, "title": "Mr. Blue Sky", "tt2dsp": { "tt_to_dsp_song_infos": [ { "meta_song_id": "6716023388202076162", "platform": 1, "song_id": "1054525017", "token": { "apple_music_token": { "developer_token": "eyJhbGciOiJFUzI1NiIsImtpZCI6Ikc2Q0dLMjdWQzMifQ.eyJleHAiOjE3ODg5MTI2MTksImlhdCI6MTc4ODY1MzQxOSwiaXNzIjoiTUo3OTdEOFU2RiJ9.-ZmRZnydpjtisBcBI600QSfLwMvyURjNaQgkWGuCJTdVEkMBBORBkByuxhoCUxCF_6OTJoJyQyKXrs3WjaudIw" } } } ] } }, "officalItem": false, "originalItem": false, "penaltyContext": { "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "playlistId": "7637624139910220558", "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 2134, "commentCount": 22, "diggCount": 3528, "playCount": 153100, "shareCount": 1186 }, "statsV2": { "collectCount": "2134", "commentCount": "22", "diggCount": "3528", "playCount": "153100", "repostCount": "0", "shareCount": "1186" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 1614, "hashtagName": "chicken", "isCommerce": false, "start": 1606, "subType": 0, "type": 1 } ], "textLanguage": "en", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 4935471, "FileCs": "c:0-15904-9f2a", "FileHash": "45666d91689284bc2977dc53ed56c2e8", "Height": 1280, "Uri": "v12044gd0000d7uv2a7og65nh748d220", "UrlKey": "v12044gd0000d7uv2a7og65nh748d220_h264_720p_2276508", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4AQ9iGKxfiSB9sEIPcA3bC3wpiMBPtEi0yiIE/?a=1988&bti=ODszNWYuMDE6&&bt=2223&ft=-Csk_mH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=PGg5OGc1N2c0OzdpODVnaUBpMzU7OnE5cmR5OjMzZzczNEAzYzQuLS8wNmIxMWBfXjFiYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&expire=1788851318&l=20260906150821E6B432A1BD2A28C99007&ply_type=2&policy=2&signature=c8bab091a81ef1895cf240b6d33a29e2&tk=tt_chain_token&btag=e000b8000" ], "Width": 720 }, "VQScore": "77", "bitrate": 2276508, "bitrateInfo": [ { "Bitrate": 2276508, "BitrateFPS": 30, "CodecType": "h264", "Format": "mp4", "GearName": "normal_720_0", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 81.889, \"v960\": 84.21, \"v864\": 87.947, \"v720\": 91.852}, \"ori\": {\"v1080\": 81.889, \"v960\": 84.21, \"v864\": 87.947, \"v720\": 91.852}}}", "PlayAddr": { "DataSize": 4935471, "FileCs": "c:0-15904-9f2a", "FileHash": "45666d91689284bc2977dc53ed56c2e8", "Height": 1280, "Uri": "v12044gd0000d7uv2a7og65nh748d220", "UrlKey": "v12044gd0000d7uv2a7og65nh748d220_h264_720p_2276508", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4AQ9iGKxfiSB9sEIPcA3bC3wpiMBPtEi0yiIE/?a=1988&bti=ODszNWYuMDE6&&bt=2223&ft=-Csk_mH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=PGg5OGc1N2c0OzdpODVnaUBpMzU7OnE5cmR5OjMzZzczNEAzYzQuLS8wNmIxMWBfXjFiYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&expire=1788851318&l=20260906150821E6B432A1BD2A28C99007&ply_type=2&policy=2&signature=c8bab091a81ef1895cf240b6d33a29e2&tk=tt_chain_token&btag=e000b8000" ], "Width": 720 }, "QualityType": 10, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 404889}, {\\\"time\\\": 2, \\\"offset\\\": 685092}, {\\\"time\\\": 3, \\\"offset\\\": 937330}, {\\\"time\\\": 4, \\\"offset\\\": 1150204}, {\\\"time\\\": 5, \\\"offset\\\": 1325906}, {\\\"time\\\": 10, \\\"offset\\\": 2705884}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 81.889, \\\"v960\\\": 84.21, \\\"v864\\\": 87.947, \\\"v720\\\": 91.852}, \\\"ori\\\": {\\\"v1080\\\": 81.889, \\\"v960\\\": 84.21, \\\"v864\\\": 87.947...(truncated)" } ], "claInfo": { "captionInfos": [ { "captionFormat": "webvtt", "claSubtitleID": "7637530093968919309", "expire": "1788851318", "isAutoGen": true, "isOriginalCaption": true, "language": "eng-US", "languageCode": "en", "languageID": "2", "subID": "-1723613017", "subtitleType": "1", "translationType": "0", "url": "https://v16-webapp.tiktok.com/dc6e183e040a06c8dd818a726b6866e3/6a9fb476/video/tos/alisg/tos-alisg-v-37c799-sg/67920efa8c98476c9760f122b7547607/?a=1988&bti=ODszNWYuMDE6&&bt=11054&ft=-ElcomH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=MzU7OnE5cmR5OjMzZzczNEBpMzU7OnE5cmR5OjMzZzczNEAvYTFlMmQ0L3JhLS1kMS9zYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&l=20260906150821E6B432A1BD2A28C99007&btag=e00078000", "urlList": [ "https://v16-webapp.tiktok.com/dc6e183e040a06c8dd818a726b6866e3/6a9fb476/video/tos/alisg/tos-alisg-v-37c799-sg/67920efa8c98476c9760f122b7547607/?a=1988&bti=ODszNWYuMDE6&&bt=11054&ft=-ElcomH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=MzU7OnE5cmR5OjMzZzczNEBpMzU7OnE5cmR5OjMzZzczNEAvYTFlMmQ0L3JhLS1kMS9zYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&l=20260906150821E6B432A1BD2A28C99007&btag=e00078000" ], "variant": "big_caption" } ], "captionsType": 1, "enableAutoCaption": true, "hasOriginalAudio": true, "originalLanguageInfo": { "canTranslateRealTimeNoCheck": true, "language": "eng-US", "languageCode": "en", "languageID": "2" } }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=3fy%2BAXM1HrryGYKsea7%2FXIfgW%2Bg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "720p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ogEOiViEIBw0KXfPc9ip9tjGESxiOCAiBA3IQ3/?a=1988&bti=ODszNWYuMDE6&&bt=1996&ft=-Csk_mH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=ZGhnZmU4aTk8Zzs0NDlkNkBpMzU7OnE5cmR5OjMzZzczNEAuNDJgNjZgNWAxMzVjMzEtYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&expire=1788851318&l=20260906150821E6B432A1BD2A28C99007&ply_type=2&policy=2&signature=0c175d4a6a4733be772de0a9709d592e&tk=tt_chain_token&btag=e000b8000", "duration": 17, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okWfnOQvEFDNAEAoQ7XRFw5eIIFFGeEEudpEfN~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=zJxVIHSR2Q8Utt1Bva6GhBh8SoM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1280, "id": "7637529980162805006", "originCover": "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/osi390kzPAAmBcBKCR49xiIwiiIr3fl2GpiIBE~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=HTfDIjl93xJY2fXmQvW1aA0atMM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4AQ9iGKxfiSB9sEIPcA3bC3wpiMBPtEi0yiIE/?a=1988&bti=ODszNWYuMDE6&&bt=2223&ft=-Csk_mH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=PGg5OGc1N2c0OzdpODVnaUBpMzU7OnE5cmR5OjMzZzczNEAzYzQuLS8wNmIxMWBfXjFiYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&expire=1788851318&l=20260906150821E6B432A1BD2A28C99007&ply_type=2&policy=2&signature=c8bab091a81ef1895cf240b6d33a29e2&tk=tt_chain_token&btag=e000b8000", "ratio": "720p", "size": 4935471, "subtitleInfos": [ { "Format": "webvtt", "LanguageCodeName": "eng-US", "LanguageID": "2", "Size": 166, "Source": "ASR", "Url": "https://v16-webapp.tiktok.com/dc6e183e040a06c8dd818a726b6866e3/6a9fb476/video/tos/alisg/tos-alisg-v-37c799-sg/67920efa8c98476c9760f122b7547607/?a=1988&bti=ODszNWYuMDE6&&bt=11054&ft=-ElcomH1PD12NwcPJn-UxtG5XY6e3wv25XcAp&mime_type=video_mp4&rc=MzU7OnE5cmR5OjMzZzczNEBpMzU7OnE5cmR5OjMzZzczNEAvYTFlMmQ0L3JhLS1kMS9zYSMvYTFlMmQ0L3JhLS1kMS9zcw%3D%3D&l=20260906150821E6B432A1BD2A28C99007&btag=e00078000", "UrlExpire": 1788851318, "Version": "1:big_caption" } ], "videoID": "v12044gd0000d7uv2a7og65nh748d220", "videoQuality": "normal", "volumeInfo": { "Loudness": -11.4, "Peak": 1 }, "width": 720, "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=bao7g%2BYjkARVE%2BlCwj32ZtehNKI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=09%2F2%2BmlMUK21yToIqXF%2BGrXjImo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=XdO31HP%2FVnI390UU3LZAbNjfQOo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/okyFeAaEeIV4IQgnf9W8OFA8IW7uJQgJG6MeRR~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=oMBOuvCzWeonwQnhmgrF8vHiWEM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "20260906150821E6B432A1BD2A28C99007" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/place/info": { "get": { "tags": [ "Place" ], "summary": "Get Place Info", "description": "Get place (POI / location) info by ID.\n\nReturns the location object: name, address, city, country, and\ncover photo.", "operationId": "getPlaceInfo", "parameters": [ { "name": "placeId", "in": "query", "required": false, "schema": { "type": "string", "description": "Place (POI) id - the poi.id field of any post object.", "title": "Placeid", "default": "42203860797713198", "example": "42203860797713198" }, "description": "Place (POI) id - the poi.id field of any post object." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "extra": { "fatal_item_ids": [], "logid": "20260906150831153B3064E505E4BF6551", "now": 1788678512000 }, "log_pb": { "impr_id": "20260906150831153B3064E505E4BF6551" }, "poiInfo": { "poi": { "address": "89 South St, New York, NY 10038, USA", "allLevelGeoPoiInfo": {}, "category": "Mexican Restaurant", "city": "New York", "cityCode": "5128581", "country": "", "countryCode": "6252001", "fatherPoiId": "22535865201205278", "fatherPoiName": "New York", "id": "42203860797713198", "indexEnabled": true, "isClaimed": false, "isCollected": false, "name": "Gitano NYC", "phoneInfo": { "exist": true }, "pictureAlbum": { "pictures": [ { "urlList": [ "https://p16-tiktok-poi-picture-sign-sg.ibyteimg.com/tos-alisg-i-0x5759trmt-sg/b38bba160ca3e0c18d8eeb1d4d7655ce~tplv-0x5759trmt-heic-crop-v3:800:800.jpeg?rk3s=733ab7a5&x-expires=1820164093&x-signature=ss5HywxKVVfTUdY6ENfTRTJi%2Fvw%3D" ] } ], "totalCount": 82 }, "poiDetailTags": [ { "content": "12:00 PM – 11:59 PM", "tagType": 4 } ], "poiHighlightTagModule": { "iconTags": [ { "icon": { "tuxToken": "tux://icon?token=IconWallRoller&color=UIText2&from=poi_header_tag" }, "tagContent": "Impressive aesthetic", "tagId": 54025345539 }, { "icon": { "tuxToken": "tux://icon?token=IconEmoji&color=UIText2&from=poi_header_tag" }, "tagContent": "Excellent service", "tagId": 16639031299 } ] }, "poiReviewSummary": { "maxScore": 5, "noRating": false, "score": 4.5, "totalCount": 191 }, "province": "", "ttTypeCode": "05a3b1", "ttTypeNameMedium": "Mexican Cuisine", "ttTypeNameSuper": "Food and Drink", "ttTypeNameTiny": "Mexican Restaurant", "type": 2, "typeCode": "" }, "stats": { "videoCount": 6304 } }, "shareMeta": { "desc": "89 South St, New York, NY 10038, USA", "title": "Gitano NYC" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/place/posts": { "get": { "tags": [ "Place" ], "summary": "Get Place Posts", "description": "Get posts filmed at a place (POI / location).\n\nReturns itemList[] with cursor/hasMore pagination.", "operationId": "getPlacePosts", "parameters": [ { "name": "placeId", "in": "query", "required": false, "schema": { "type": "string", "description": "Place (POI) id - the poi.id field of any post object.", "title": "Placeid", "default": "42203860797713198", "example": "42203860797713198" }, "description": "Place (POI) id - the poi.id field of any post object." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "11006", "extra": { "fatal_item_ids": [], "logid": "20260906150832C2F37FDCB55AE1D3249A", "now": 1788678513000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 111, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4239b278b157004c9ac50e7cbafdee7~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=27134ad2&x-expires=1788850800&x-signature=hcKplhtwbBONxU3nCKfXEUx1E2E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4239b278b157004c9ac50e7cbafdee7~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=dcd0e5fb&x-expires=1788850800&x-signature=2wCPqvTXjOU9GKU7Jds3emjoFts%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4239b278b157004c9ac50e7cbafdee7~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=caa678e7&x-expires=1788850800&x-signature=GByzFl5MDhFErMkR7E3tB%2BaYBZM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "7380873626273449002", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Reserve NYC", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAA-H1snGrleUaHkI6-71BeeeJoOJRYzYQtnjnHNRAQd7oB8DRXusAB7sP29sH5F5kW", "secret": false, "shortDramaCreator": {}, "signature": "Drink Dine Travel 🥂", "stitchSetting": 0, "uniqueId": "reserve.nyc", "verified": false }, "authorStats": { "diggCount": 769, "followerCount": 50600, "followingCount": 0, "friendCount": 0, "heart": 1500000, "heartCount": 1500000, "videoCount": 201 }, "authorStatsV2": { "diggCount": "769", "followerCount": "50600", "followingCount": "0", "friendCount": "0", "heart": "1500000", "heartCount": "1500000", "videoCount": "201" }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "6185029", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "mexicanrestaurant" } ], "collected": false, "contents": [ { "desc": "📍GITANO" } ], "createTime": 1784069178, "desc": "📍GITANO This Waterfront restaurant in NYC is perfect for the Summer! With a vibrant atmosphere and great music, Gitano is definitely a restaurant & lounge you should add to the list! I would recommend for a birthday or fun night out! As for the food, the appetizers were my favorite dishes of the night. The shrimp ceviche was amazing! Check them out @GITANO 🥂 #mexicanrestaurant #waterfrontrestaurant #nycrestaurant #birthdaydinner #nyceats ", "digged": false, "diversificationId": 10085, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7662518708434177310", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Reserve NYC", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4239b278b157004c9ac50e7cbafdee7~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=27134ad2&x-expires=1788850800&x-signature=hcKplhtwbBONxU3nCKfXEUx1E2E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4239b278b157004c9ac50e7cbafdee7~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=dcd0e5fb&x-expires=1788850800&x-signature=2wCPqvTXjOU9GKU7Jds3emjoFts%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b4239b278b157004c9ac50e7cbafdee7~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=caa678e7&x-expires=1788850800&x-signature=GByzFl5MDhFErMkR7E3tB%2BaYBZM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 26, "id": "7662518706659937055", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v58.tiktokcdn.com/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oYfqc8JBU7DVfWcE3vFw9EADE9AtEABkrGAVsC/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7Tha9n~GXq8Zmo&mime_type=audio_mpeg&rc=ajl5OGw5cmllPDMzaTU8NEBpajl5OGw5cmllPDMzaTU8NEBybGtfMmRjbF9hLS1kMTJzYSNybGtfMmRjbF9hLS1kMTJzcw%3D%3D&vvpl=1&l=20260906150832C2F37FDCB55AE1D3249A&VExpiration=1788764938&VSignature=RjoY0f94m-n5DOnUJzNuLQ&btag=e00078000&sp_exp=hash_v0", "private": false, "shoot_duration": 26, "title": "original sound", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "arb_content_safety_status": 102, "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "ec_global_verdict": 1, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "poi": { "address": "89 South St, New York, NY 10038, USA", "category": "Food and Drink", "city": "New York", "cityCode": "5128581", "country": "", "countryCode": "6252001", "fatherPoiId": "", "fatherPoiName": "New York", "id": "42203860797713198", "name": "Gitano NYC", "province": "", "ttTypeCode": "05a3b1", "ttTypeCodeL1": "050000", "ttTypeNameMedium": "Mexican Cuisine", "ttTypeNameSuper": "Food and Drink", "ttTypeNameTiny": "Mexican Restaurant", "type": 0, "typeCode": "" }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 26700, "commentCount": 191, "diggCount": 52700, "playCount": 637900, "shareCount": 16200 }, "statsV2": { "collectCount": "26730", "commentCount": "191", "diggCount": "52700", "playCount": "637900", "repostCount": "0", "shareCount": "16200" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 361, "hashtagName": "", "isCommerce": false, "secUid": "MS4wLjABAAAA9euTnsDFfvb3S_qlK4H3MoRRO3GCLVaJ07QxyTOQ3y4m01PAA3-hGC7g1YNA91-P", "start": 354, "subType": 0, "type": 0, "userId": "7592887197729178637", "userUniqueId": "gitano" } ], "textLanguage": "en", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 6622181, "FileCs": "c:0-23256-af77", "FileHash": "ba077719badb9a8f238b36ddc0ad756e", "Height": 1280, "Uri": "v15044gf0000d9bbnonog65gpaounmd0", "UrlKey": "v15044gf0000d9bbnonog65gpaounmd0_h264_720p_2006721", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oc8pfvGlRHMWeaxQVeWfFgQMQoZYRAFGuZAUVA/?a=1988&bti=ODszNWYuMDE6&&bt=1959&ft=-Csk_mH1PD12NmcPJn-UxtZ2aY6e3wv25NcAp&mime_type=video_mp4&rc=aTg0NDo0ZWY1OTY6MzhmPEBpM3B4ZGo5cnJlPDMzaTczNEAtXzBgLS8uNTIxMTE1LTY0YSNha2xtMmRra19hLS1kMTJzcw%3D%3D&expire=1788851339&l=20260906150832C2F37FDCB55AE1D3249A&ply_type=2&policy=2&signature=90bb4b5d980f8c68be5aad47631f5e53&tk=tt_chain_token&btag=e000b8000" ], "Width": 720 }, "VQScore": "69.03", "bitrate": 2006721, "bitrateInfo": [ { "Bitrate": 2276802, "BitrateFPS": 60, "CodecType": "h265_hvc1", "Format": "mp4", "GearName": "adapt_lowest_1080_1", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 95.283, \"v960\": 96.255, \"v864\": 96.709, \"v720\": 97.739}, \"ori\": {\"v1080\": 88.964, \"v960\": 90.64, \"v864\": 91.662, \"v720\": 93.141}}}", "PlayAddr": { "DataSize": 7500357, "FileCs": "c:0-30572-d61c", "FileHash": "8c40b981f66af4318218cc5bc1dff834", "Height": 1920, "Uri": "v15044gf0000d9bbnonog65gpaounmd0", "UrlKey": "v15044gf0000d9bbnonog65gpaounmd0_bytevc1_1080p_2276802", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/o4AAxbHPrHlwdIYdB7EEariQBaJura2Vi4vRy/?a=1988&bti=ODszNWYuMDE6&&bt=2223&ft=-Csk_mH1PD12NmcPJn-UxtZ2aY6e3wv25NcAp&mime_type=video_mp4&rc=NDM6aTxlZmlmNjZlNmg7OEBpM3B4ZGo5cnJlPDMzaTczNEAwMDNeMDMtNmMxNTVeLmAvYSNha2xtMmRra19hLS1kMTJzcw%3D%3D&expire=1788851339&l=20260906150832C2F37FDCB55AE1D3249A&ply_type=2&policy=2&signature=a8a9ca0b77b5c6bc304e9c5357ccdf00&tk=tt_chain_token&btag=e000b8000" ], "Width": 1080 }, "QualityType": 2, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 612592}, {\\\"time\\\": 2, \\\"offset\\\": 1002799}, {\\\"time\\\": 3, \\\"offset\\\": 1115193}, {\\\"time\\\": 4, \\\"offset\\\": 1370091}, {\\\"time\\\": 5, \\\"offset\\\": 1659463}, {\\\"time\\\": 10, \\\"offset\\\": 3141641}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 95.283, \\\"v960\\\": 96.255, \\\"v864\\\": 96.709, \\\"v720\\\": 97.739}, \\\"ori\\\": {\\\"v1080\\\": 88.964, \\\"v960\\\": 90.64, \\\"v864\\\": 91....(truncated)" } ], "claInfo": { "enableAutoCaption": true, "hasOriginalAudio": true, "noCaptionReason": 3 }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/os5lwF4irAaVaBHCErQaa2ABIRbyWIE7ABviv~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=8BSQhTk4jWfVG3d9NEedMHLbKLM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "720p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/osAaiUavBrAK7rWwlGVHEQiEB24vrywIFapbR/?a=1988&bti=ODszNWYuMDE6&&bt=1651&ft=-Csk_mH1PD12NmcPJn-UxtZ2aY6e3wv25NcAp&mime_type=video_mp4&rc=OmdkaGc8aTtkPDdmNTxlNUBpM3B4ZGo5cnJlPDMzaTczNEAwMS5fX2JfX2MxNjU2XjNfYSNha2xtMmRra19hLS1kMTJzcw%3D%3D&expire=1788851339&l=20260906150832C2F37FDCB55AE1D3249A&ply_type=2&policy=2&signature=f660ec2e74c1ca15b4572c0e661d83b0&tk=tt_chain_token&btag=e000b8000", "duration": 26, "dynamicCover": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oswrlv73aFyAiWxVHIRCaBEEVrGIA4CBiv27a~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=PAL3Vbfwh82jdb%2BN18xM3v6%2FXog%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1280, "id": "7662518708434177310", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o0GVKQFeAGKgZHHpouUWQfvWgFY8uU2afAMeRV~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=lOalv1vPtSogIGLAtwlsDjz0D8k%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oc8pfvGlRHMWeaxQVeWfFgQMQoZYRAFGuZAUVA/?a=1988&bti=ODszNWYuMDE6&&bt=1959&ft=-Csk_mH1PD12NmcPJn-UxtZ2aY6e3wv25NcAp&mime_type=video_mp4&rc=aTg0NDo0ZWY1OTY6MzhmPEBpM3B4ZGo5cnJlPDMzaTczNEAtXzBgLS8uNTIxMTE1LTY0YSNha2xtMmRra19hLS1kMTJzcw%3D%3D&expire=1788851339&l=20260906150832C2F37FDCB55AE1D3249A&ply_type=2&policy=2&signature=90bb4b5d980f8c68be5aad47631f5e53&tk=tt_chain_token&btag=e000b8000", "ratio": "720p", "size": 6622181, "videoID": "v15044gf0000d9bbnonog65gpaounmd0", "videoQuality": "normal", "volumeInfo": { "Loudness": -19.6, "Peak": 0.32734 }, "width": 720, "zoomCover": { "240": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/os5lwF4irAaVaBHCErQaa2ABIRbyWIE7ABviv~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=rYYyMp4bhuRlFXIa76ZEYRLz2JE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/os5lwF4irAaVaBHCErQaa2ABIRbyWIE7ABviv~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=kt6tXLSRC3htIYtB49NYxwIqEcE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/os5lwF4irAaVaBHCErQaa2ABIRbyWIE7ABviv~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=El9O5g%2BMYyWtGe%2BhpiGzXk0HijI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/os5lwF4irAaVaBHCErQaa2ABIRbyWIE7ABviv~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=zV8MhqDXMVtAcVWQN6pYMuzTAsE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "20260906150832C2F37FDCB55AE1D3249A" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/drama/detail": { "get": { "tags": [ "Drama" ], "summary": "Get Drama Detail", "description": "Get mini-drama series detail by ID.\n\nReturns dramaInfo: title, cover, episode count, description, and\nthe creator's user object.", "operationId": "getDramaDetail", "parameters": [ { "name": "dramaId", "in": "query", "required": false, "schema": { "type": "string", "title": "Dramaid", "default": "7682314230347240468", "example": "7682314230347240468" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "dramaInfo": { "author": { "stats": { "diggCount": 0, "followerCount": 63500, "followingCount": 0, "friendCount": 0, "heart": 1500000, "heartCount": 1500000, "videoCount": 0 }, "statsV2": { "diggCount": "0", "followerCount": "63451", "followingCount": "0", "friendCount": "0", "heart": "1477407", "heartCount": "1477407", "videoCount": "0" }, "user": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=20683155&x-expires=1788854400&x-signature=NnnhjXMuhenpdrRAMmGwzYB4aAg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e76ac2b6&x-expires=1788854400&x-signature=LaPSb%2BMdfs45etAlKd%2Bv5A2%2Ba0I%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=f9ad820b&x-expires=1788854400&x-signature=86Uh7y8msGqPUZ0SfYqmi%2BJx50A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "followingVisibility": 1, "ftc": false, "id": "7670391416036688912", "isADVirtual": false, "isEmbedBanned": false, "nickNameModifyTime": 1785902177, "nickname": "MuffinDrama", "openFavorite": false, "privateAccount": false, "profileTab": {}, "relation": 0, "secUid": "MS4wLjABAAAA1uQSVK4GCIJo0ZkuAhQNqPCk842cyLa4BYUj7snSejijMOyTBO2P_lhMVyf-VezS", "secret": false, "shortDramaCreator": { "isShortDramaCreator": true }, "signature": "New original short dramas updated every day!", "stitchSetting": 0, "ttSeller": false, "uniqueId": "muffindrama_vn", "verified": false } }, "authorUID": "7670391416036688912", "cover": { "urlList": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-tiktokx-origin.image?dr=14575&x-expires=1788854400&x-signature=qJMoA8LFXe12A3KUwVQg04pTxG0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" ] }, "description": "Sau khi Gia Mơ và A Mi công khai bộc lộ sự lừa dối của họ, chế giễu những hy sinh của Ê Ma, cô ấy đứng vững với phẩm giá. Uy Liêm — người thừa kế Gia đình Lựu ngụy trang thành thợ sửa chữa — chứng kiến sự kiên cường của cô ấy. Khi A Mi đấu giá hợp đồng, sự im lặng bình tĩnh của anh ấy báo hiệu công lý đang đến gần: sự thật vượt qua sự lừa dối, sự tôn trọng vượt qua sự xấu hổ.", "dramaID": "7682314230347240468", "dramaName": "Chồng Thợ Nước Là Chủ Tịch Lựu", "isLimitedFree": true, "numVideos": 42, "numWatched": "81472", "themes": [ { "tagID": "7628991193716069392", "tagKey": "tag_Mistakenidentities_Relationship", "tagVal": "Mistaken Identities" } ], "totalDuration": "3670", "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788854400&x-signature=WNkBtRaspO8l1iAkZ0qTIhuOIBc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788854400&x-signature=GUr6r6PN3cFER%2BOI5Z285zX8H%2Fg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p19-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788854400&x-signature=4ZEkY%2F70G0QzDcPrn2xwLyCPwvo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-alisg-i-fjfgkmyddx-sg/9caeb79527da449796b265f741aeff8d~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788854400&x-signature=ZzTfglU9qzyqS5GikCzoAMol5aA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } }, "extra": { "fatal_item_ids": [], "logid": "20260906160738C9A9E0971841517F7C65", "now": 1788682058000 }, "log_pb": { "impr_id": "20260906160738C9A9E0971841517F7C65" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/drama/episodes": { "get": { "tags": [ "Drama" ], "summary": "Get Drama Episodes", "description": "Get the episodes of a mini-drama series.\n\nReturns itemList[] of episode posts with cursor pagination.\nEpisodes reliably carry subtitle tracks (see /v1/post/subtitles).", "operationId": "getDramaEpisodes", "parameters": [ { "name": "dramaId", "in": "query", "required": false, "schema": { "type": "string", "title": "Dramaid", "default": "7682314230347240468", "example": "7682314230347240468" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "cursor": "1", "extra": { "fatal_item_ids": [], "logid": "2026090616073984AFA021229820DAED1C", "now": 1788682059000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 100, "HasPromoteEntry": 0, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=20683155&x-expires=1788854400&x-signature=NnnhjXMuhenpdrRAMmGwzYB4aAg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e76ac2b6&x-expires=1788854400&x-signature=LaPSb%2BMdfs45etAlKd%2Bv5A2%2Ba0I%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=f9ad820b&x-expires=1788854400&x-signature=86Uh7y8msGqPUZ0SfYqmi%2BJx50A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "7670391416036688912", "isADVirtual": false, "isEmbedBanned": false, "nickname": "MuffinDrama", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAA1uQSVK4GCIJo0ZkuAhQNqPCk842cyLa4BYUj7snSejijMOyTBO2P_lhMVyf-VezS", "secret": false, "shortDramaCreator": { "isShortDramaCreator": true }, "signature": "New original short dramas updated every day!", "stitchSetting": 0, "uniqueId": "muffindrama_vn", "verified": false }, "authorStats": { "diggCount": 0, "followerCount": 63500, "followingCount": 0, "friendCount": 0, "heart": 1500000, "heartCount": 1500000, "videoCount": 0 }, "authorStatsV2": { "diggCount": "0", "followerCount": "63500", "followingCount": "0", "friendCount": "0", "heart": "1500000", "heartCount": "1500000", "videoCount": "0" }, "backendSourceEventTracking": "", "collected": false, "contents": [ { "desc": "Người Thợ Sửa Nước Tôi Kết Hôn Hóa Ra Là Chủ Tịch Tập Đoàn Lựu" } ], "createTime": 1788678237, "creatorAIComment": { "eligibleVideo": false, "hasAITopic": false, "notEligibleReason": 204 }, "desc": "Người Thợ Sửa Nước Tôi Kết Hôn Hóa Ra Là Chủ Tịch Tập Đoàn Lựu", "digged": false, "diversificationId": 10052, "duetDisplay": 0, "forFriend": false, "id": "7682314414141213973", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "MuffinDrama", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=20683155&x-expires=1788854400&x-signature=NnnhjXMuhenpdrRAMmGwzYB4aAg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e76ac2b6&x-expires=1788854400&x-signature=LaPSb%2BMdfs45etAlKd%2Bv5A2%2Ba0I%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/5c5931301debbc56d875b822ff28a2b3~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=f9ad820b&x-expires=1788854400&x-signature=86Uh7y8msGqPUZ0SfYqmi%2BJx50A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 139, "id": "7682314474791570183", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-27dcd7/o09AEBCFQIA1EJAg6eUntBIRwiIPDf3BQJBqC6/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7Th1an~GXq8Zmo&mime_type=audio_mpeg&rc=anB0anQ5cm1rZDMzODU8NEBpanB0anQ5cm1rZDMzODU8NEBsZF9yMmRzLWJhLS1kMS1zYSNsZF9yMmRzLWJhLS1kMS1zcw%3D%3D&vvpl=1&l=2026090616073984AFA021229820DAED1C&VExpiration=1788768598&VSignature=EiRHz__c3hHL4rROM4GE8w&btag=e00050000&sp_exp=hash_v0", "private": false, "shoot_duration": 139, "title": "original sound - MuffinDrama", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 0, "commentCount": 0, "diggCount": 1, "playCount": 103, "shareCount": 0 }, "statsV2": { "collectCount": "0", "commentCount": "0", "diggCount": "1", "playCount": "103", "repostCount": "0", "shareCount": "0" }, "stitchDisplay": 0, "textLanguage": "vi", "textTranslatable": true, "video": { "PlayAddrStruct": { "DataSize": 16713819, "FileCs": "c:0-115180-1f69", "FileHash": "b60d1e9da22f4374e4c518fe931b991e", "Height": 1004, "Uri": "v1c025g50000daeh06fog65jj2fsj34g", "UrlKey": "v1c025g50000daeh06fog65jj2fsj34g_h264_540p_959578", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/oARrA4VAinxYezk6GDgmMOLUSfAC8AeOIOE4nX/?a=1988&bti=ODszNWYuMDE6&&bt=937&ft=-Csk_mH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=Mzs1M2lnZzQ5PDc3NDw0O0BpajZ2NW05cjlrZDMzODgzNEAwNC00MzAxNjYxLi8tXmIxYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&expire=1788854998&l=2026090616073984AFA021229820DAED1C&ply_type=2&policy=2&signature=06a88c707235ddd7dbc228839cec5008&tk=tt_chain_token&btag=e00090000" ], "Width": 576 }, "VQScore": "65.15", "bitrate": 959578, "bitrateInfo": [ { "Bitrate": 959578, "BitrateFPS": 30, "CodecType": "h264", "Format": "mp4", "GearName": "normal_540_0", "MVMAF": "{\"v2.0\": {}}", "PlayAddr": { "DataSize": 16713819, "FileCs": "c:0-115180-1f69", "FileHash": "b60d1e9da22f4374e4c518fe931b991e", "Height": 1004, "Uri": "v1c025g50000daeh06fog65jj2fsj34g", "UrlKey": "v1c025g50000daeh06fog65jj2fsj34g_h264_540p_959578", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/oARrA4VAinxYezk6GDgmMOLUSfAC8AeOIOE4nX/?a=1988&bti=ODszNWYuMDE6&&bt=937&ft=-Csk_mH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=Mzs1M2lnZzQ5PDc3NDw0O0BpajZ2NW05cjlrZDMzODgzNEAwNC00MzAxNjYxLi8tXmIxYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&expire=1788854998&l=2026090616073984AFA021229820DAED1C&ply_type=2&policy=2&signature=06a88c707235ddd7dbc228839cec5008&tk=tt_chain_token&btag=e00090000" ], "Width": 576 }, "QualityType": 20, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 227570}, {\\\"time\\\": 2, \\\"offset\\\": 418627}, {\\\"time\\\": 3, \\\"offset\\\": 638604}, {\\\"time\\\": 4, \\\"offset\\\": 756770}, {\\\"time\\\": 5, \\\"offset\\\": 887608}, {\\\"time\\\": 10, \\\"offset\\\": 1289992}]\",\"mvmaf\":\"{\\\"v2.0\\\": {}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"49a869e099a9a051730b1d31501a61e3\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":32046}" } ], "claInfo": { "captionInfos": [ { "captionFormat": "webvtt", "claSubtitleID": "7682314377032354580", "expire": "1788854998", "isAutoGen": true, "isOriginalCaption": true, "language": "eng-US", "languageCode": "en", "languageID": "2", "subID": "-1427234188", "subtitleType": "1", "translationType": "0", "url": "https://v16-webapp.tiktok.com/6019ab7965e378369eba3dc6282c0eba/6a9fc2d6/video/tos/alisg/tos-alisg-pv-0037/e79e0c7d73d0401fac1ff3dd595b5e6d/?a=1988&bti=ODszNWYuMDE6&&bt=5082&ft=-ElcomH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=ajZ2NW05cjlrZDMzODgzNEBpajZ2NW05cjlrZDMzODgzNEAxZ2NnMmRjLWJhLS1kL2BzYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&l=2026090616073984AFA021229820DAED1C&btag=e00050000", "urlList": [ "https://v16-webapp.tiktok.com/6019ab7965e378369eba3dc6282c0eba/6a9fc2d6/video/tos/alisg/tos-alisg-pv-0037/e79e0c7d73d0401fac1ff3dd595b5e6d/?a=1988&bti=ODszNWYuMDE6&&bt=5082&ft=-ElcomH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=ajZ2NW05cjlrZDMzODgzNEBpajZ2NW05cjlrZDMzODgzNEAxZ2NnMmRjLWJhLS1kL2BzYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&l=2026090616073984AFA021229820DAED1C&btag=e00050000" ], "variant": "big_caption" } ], "captionsType": 1, "enableAutoCaption": true, "hasOriginalAudio": false, "originalLanguageInfo": { "canTranslateRealTimeNoCheck": true, "language": "eng-US", "languageCode": "en", "languageID": "2" } }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-c7a081-sg/oEaDCSFlSIDrzmCyUqegfIExqVQZZ0uBULTURB~tplv-tiktokx-origin.image?dr=14575&x-expires=1788854400&x-signature=iJnyARjqBQcv1unHze8cQi%2B19F0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "540p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/oMcBnTTAWRfDzMn5QQWVLZfACjBFdEEqgIJEJK/?a=1988&bti=ODszNWYuMDE6&&bt=961&eid=20480&ft=-Csk_mH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=ZjQ8O2g1NjdkaDU5MztkO0BpajZ2NW05cjlrZDMzODgzNEA2MTAxLTUvXjYxYzFgLy1fYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&expire=1788854998&l=2026090616073984AFA021229820DAED1C&ply_type=2&policy=2&signature=d14ebd3fd9abe5b82b3c37823c095c3d&tk=tt_chain_token&btag=e00090000", "duration": 139, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/osGdriSxVQ4EEfDOECOLlKAIQeGDYvATzAecEn~tplv-tiktokx-origin.image?dr=14575&x-expires=1788854400&x-signature=KeSIS39B%2Bd5K2qCs2nfaUhZpcNc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1004, "id": "7682314414141213973", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ocnVOBGTQDCIe2OseEAAQsOLeidz0SGAEtYr4E~tplv-tiktokx-origin.image?dr=14575&x-expires=1788854400&x-signature=xmD7f9ZK6kwGg6i1tZP53LCCvwk%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/oARrA4VAinxYezk6GDgmMOLUSfAC8AeOIOE4nX/?a=1988&bti=ODszNWYuMDE6&&bt=937&ft=-Csk_mH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=Mzs1M2lnZzQ5PDc3NDw0O0BpajZ2NW05cjlrZDMzODgzNEAwNC00MzAxNjYxLi8tXmIxYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&expire=1788854998&l=2026090616073984AFA021229820DAED1C&ply_type=2&policy=2&signature=06a88c707235ddd7dbc228839cec5008&tk=tt_chain_token&btag=e00090000", "ratio": "540p", "size": 16713819, "subtitleInfos": [ { "Format": "webvtt", "LanguageCodeName": "eng-US", "LanguageID": "2", "Size": 3126, "Source": "ASR", "Url": "https://v16-webapp.tiktok.com/6019ab7965e378369eba3dc6282c0eba/6a9fc2d6/video/tos/alisg/tos-alisg-pv-0037/e79e0c7d73d0401fac1ff3dd595b5e6d/?a=1988&bti=ODszNWYuMDE6&&bt=5082&ft=-ElcomH1PD12NC8PJn-UxXo5SY6e3wv25WcAp&mime_type=video_mp4&rc=ajZ2NW05cjlrZDMzODgzNEBpajZ2NW05cjlrZDMzODgzNEAxZ2NnMmRjLWJhLS1kL2BzYSMxZ2NnMmRjLWJhLS1kL2Bzcw%3D%3D&l=2026090616073984AFA021229820DAED1C&btag=e00050000", "UrlExpire": 1788854998, "Version": "1:big_caption" } ], "videoID": "v1c025g50000daeh06fog65jj2fsj34g", "videoQuality": "normal", "volumeInfo": { "Loudness": -11.3, "Peak": 1 }, "width": 576, "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-c7a081-sg/oEaDCSFlSIDrzmCyUqegfIExqVQZZ0uBULTURB~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788854400&x-signature=TVouu4Z8CwZ%2BIp77udeZwC%2FCzAQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-c7a081-sg/oEaDCSFlSIDrzmCyUqegfIExqVQZZ0uBULTURB~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788854400&x-signature=d4nY1gNhluxNShBmzWi6b2YrB1A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-c7a081-sg/oEaDCSFlSIDrzmCyUqegfIExqVQZZ0uBULTURB~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788854400&x-signature=dEZ3qjWiE429%2Fg%2BPURLZ1TVnhFw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-c7a081-sg/oEaDCSFlSIDrzmCyUqegfIExqVQZZ0uBULTURB~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788854400&x-signature=3bLdCmJ%2BHL1ZBHga4t6ueCuqTZg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "2026090616073984AFA021229820DAED1C" }, "statusCode": 0, "status_code": 0, "status_msg": "", "totalEpisodeCount": "42" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/feed": { "get": { "tags": [ "Feed" ], "summary": "Get Feed (For You or Explore)", "description": "Get a recommendation feed.\n\nsource=fyp returns the For-You / discover feed; source=explore\nreturns the explore feed filtered by category (100-119, 104 =\nrecommendations). Both return itemList[] with hasMore/cursor\npagination.", "operationId": "getFeed", "parameters": [ { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(fyp|explore)$", "description": "Feed source: \"fyp\" (For-You / discover recommendations, default) or \"explore\" (category-based discover feed).", "default": "fyp", "title": "Source" }, "description": "Feed source: \"fyp\" (For-You / discover recommendations, default) or \"explore\" (category-based discover feed)." }, { "name": "category", "in": "query", "required": false, "schema": { "type": "integer", "description": "Explore category id (104 = recommendations; only used when source=explore).", "default": 104, "title": "Category" }, "description": "Explore category id (104 = recommendations; only used when source=explore)." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Pagination cursor. Start at 0, then pass back the cursor returned by the previous response." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "extra": { "fatal_item_ids": [], "logid": "202609061507101C828FF3E79634867AA2", "now": 1788678430000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 104, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/df652a9d60208b44a0d798347518c8e2~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=3577254d&x-expires=1788850800&x-signature=qQqoEYDrPkAIu7HUjQMVHhMUr3k%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/df652a9d60208b44a0d798347518c8e2~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=cd9359e8&x-expires=1788850800&x-signature=UImP09FaNb%2FwYGLRE5VSqnKwvso%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/df652a9d60208b44a0d798347518c8e2~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=fc5c2a1b&x-expires=1788850800&x-signature=i5OlKv8c2%2BGH2JobGl%2ByymU6ks0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "7614152626498405394", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Kayla", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAAb8gOHLuskDyZOrjK3T1RowqFSQAPBlE1Ez00T8g3lh9B06J9vS-ZO8-s-kaZHUmj", "secret": false, "shortDramaCreator": {}, "signature": "", "stitchSetting": 0, "uniqueId": "mikayladejonge4", "verified": false }, "authorStats": { "diggCount": 1910, "followerCount": 793, "followingCount": 18, "friendCount": 0, "heart": 768400, "heartCount": 768400, "videoCount": 30 }, "authorStatsV2": { "diggCount": "1910", "followerCount": "793", "followingCount": "18", "friendCount": "0", "heart": "768400", "heartCount": "768400", "videoCount": "30" }, "backendSourceEventTracking": "fyp_ug_content_redis", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "17221930", "profileLarger": "", "profileMedium": "", "profileThumb": "", "title": "catroon" } ], "collected": false, "contents": [ { "desc": "#catroon #fyppppppppppppppppppppppp #viral #funny #foyou ", "textExtra": [ { "awemeId": "", "end": 8, "hashtagName": "catroon", "isCommerce": false, "start": 0, "subType": 0, "type": 1 } ] } ], "createTime": 1786775896, "desc": "#catroon #fyppppppppppppppppppppppp #viral #funny #foyou ", "digged": false, "diversificationId": 10003, "duetDisplay": 0, "duetEnabled": true, "effectStickers": [ { "ID": "93132019", "name": "BigHead", "stickerStats": { "useCount": 0 } } ], "forFriend": false, "id": "7674144007525534983", "isAd": false, "isProhibited": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Indie🐾❤️", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b3563196c27993c774174457ee4c0b47~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=34559909&x-expires=1788850800&x-signature=1vW2SGCzVKWp3ur4zKfO98aqfgA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b3563196c27993c774174457ee4c0b47~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=397a1b3c&x-expires=1788850800&x-signature=JfTMZHCQqGLuTpRcgVrOzkLGWxg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b3563196c27993c774174457ee4c0b47~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e4332746&x-expires=1788850800&x-signature=747%2Fnpkep7Z%2BY4PGEFrnJG55UZg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "duration": 9, "id": "7360161151793269550", "isCopyrighted": false, "is_commerce_music": true, "is_unlimited_music": false, "original": true, "playUrl": "https://v16m.tiktokcdn.com/24a9158df5104ec638a9ce7ddb9b7e33/6a9e62a7/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oUIHSFDeJUD0LIAWwJEIBuBCFAggypAYJmfw5B/?a=1180&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThVVn~GXq8Zmo&mime_type=audio_mpeg&rc=M3Zrcm45cjg7cjMzZzU8NEBpM3Zrcm45cjg7cjMzZzU8NEBwLTJlMmRra2ZgLS1kMS9zYSNwLTJlMmRra2ZgLS1kMS9zcw%3D%3D&vvpl=1&l=202609061507101C828FF3E79634867AA2&btag=e00070000&sp_exp=hash_v0", "private": false, "shoot_duration": 9, "title": "original sound", "tt2dsp": {} }, "officalItem": false, "originalItem": false, "penaltyContext": { "arb_content_safety_status": 102, "display_penalty_type": 0, "display_policy": 0, "display_ui_type": 0, "ec_global_verdict": 1, "reviewed": 0, "status": 102, "tns_status": 102, "video_status": 10 }, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 29300, "commentCount": 7523, "diggCount": 765000, "playCount": 4400000, "shareCount": 9449 }, "statsV2": { "collectCount": "29322", "commentCount": "7523", "diggCount": "765000", "playCount": "4400000", "repostCount": "0", "shareCount": "9449" }, "stickersOnItem": [ { "stickerText": [ "How I used to pet\nAnimals because \nOf cartoons 😭" ], "stickerType": 4 } ], "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "awemeId": "", "end": 8, "hashtagName": "catroon", "isCommerce": false, "start": 0, "subType": 0, "type": 1 } ], "textLanguage": "un", "textTranslatable": false, "video": { "PlayAddrStruct": { "DataSize": 526600, "FileCs": "c:0-8639-9e07", "FileHash": "2090b2c11f84823aeb2eb4227a8190df", "Height": 1024, "Uri": "v10044g50000da00g17og65mtsbrmbb0", "UrlKey": "v10044g50000da00g17og65mtsbrmbb0_h264_540p_483840", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o8WgIQW3EDAVCiC1QAFtBRqIiE7gLBhgEefyAE/?a=1988&bti=ODszNWYuMDE6&&bt=472&ft=I~da4o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=PDpmODhkZGg3NDY0PGk6NkBpM2V1dnA5cjQzZDMzODczNEBjMy8vNjZiNS0xX2FgMTQuYSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&expire=1788851238&l=202609061507101C828FF3E79634867AA2&ply_type=2&policy=2&signature=3e87a3b80737de94702a1d5bd5cac325&tk=tt_chain_token&btag=e000b0000" ], "Width": 576 }, "VQScore": "50.17", "bitrate": 483840, "bitrateInfo": [ { "Bitrate": 615920, "BitrateFPS": 27, "CodecType": "h265_hvc1", "Format": "mp4", "GearName": "adapt_lower_720_1", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 95.742, \"v960\": 97.021, \"v864\": 97.672, \"v720\": 98.408}, \"ori\": {\"v1080\": 86.276, \"v960\": 89.005, \"v864\": 90.412, \"v720\": 93.745}}}", "PlayAddr": { "DataSize": 670429, "FileCs": "c:0-8779-5096", "FileHash": "f0e50575d4dbe54346f3172601822d72", "Height": 1280, "Uri": "v10044g50000da00g17og65mtsbrmbb0", "UrlKey": "v10044g50000da00g17og65mtsbrmbb0_bytevc1_720p_615920", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o0IDqgUtf9EAEBs3aggBz2bAEsQjBWdQigfFRD/?a=1988&bti=ODszNWYuMDE6&&bt=601&ft=I~da4o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmPDQ0ZTw1O2lpOTg4NWUzPEBpM2V1dnA5cjQzZDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiMuNjIxMy4wNl4xX2A2XzM0YSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&expire=1788851238&l=202609061507101C828FF3E79634867AA2&ply_type=2&policy=2&signature=03bee658f4e0e87288d4da103bb10a54&tk=tt_chain_token&btag=e000b0000" ], "Width": 720 }, "QualityType": 14, "VideoExtra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 150372}, {\\\"time\\\": 2, \\\"offset\\\": 217981}, {\\\"time\\\": 3, \\\"offset\\\": 325336}, {\\\"time\\\": 4, \\\"offset\\\": 429286}, {\\\"time\\\": 5, \\\"offset\\\": 520986}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 95.742, \\\"v960\\\": 97.021, \\\"v864\\\": 97.672, \\\"v720\\\": 98.408}, \\\"ori\\\": {\\\"v1080\\\": 86.276, \\\"v960\\\": 89.005, \\\"v864\\\": 90.412, \\\"v720\\\": 93.745}}}\",\"ufq\":\"{\\\"enh\\...(truncated)" } ], "claInfo": { "captionInfos": [ { "captionFormat": "webvtt", "claSubtitleID": "7674173519525153554", "expire": "1788851238", "isAutoGen": true, "isOriginalCaption": true, "language": "eng-US", "languageCode": "en", "languageID": "2", "subID": "-253092907", "subtitleType": "1", "translationType": "0", "url": "https://v16-webapp.tiktok.com/fd7433fbedd4d5dfba5e05eb96df7505/6a9fb426/video/tos/alisg/tos-alisg-pv-0037/dbc0ef443af147b6ad6057e6ef221d7c/?a=1988&bti=ODszNWYuMDE6&&bt=3276&ft=IecA0o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM2V1dnA5cjQzZDMzODczNEBpM2V1dnA5cjQzZDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiNfal9xMmQ0ZC1hLS1kMS1zYSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&l=202609061507101C828FF3E79634867AA2&btag=e00070000", "urlList": [ "https://v16-webapp.tiktok.com/fd7433fbedd4d5dfba5e05eb96df7505/6a9fb426/video/tos/alisg/tos-alisg-pv-0037/dbc0ef443af147b6ad6057e6ef221d7c/?a=1988&bti=ODszNWYuMDE6&&bt=3276&ft=IecA0o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM2V1dnA5cjQzZDMzODczNEBpM2V1dnA5cjQzZDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiNfal9xMmQ0ZC1hLS1kMS1zYSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&l=202609061507101C828FF3E79634867AA2&btag=e00070000" ], "variant": "big_caption" } ], "captionsType": 1, "enableAutoCaption": true, "hasOriginalAudio": true, "originalLanguageInfo": { "canTranslateRealTimeNoCheck": true, "language": "eng-US", "languageCode": "en", "languageID": "2" } }, "codecType": "h264", "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oMQeAq2EiBA55gRit9QAGFEBgCDGWgCk3fsEVQ~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=ydxBsek0SWnZDoS9fLeY0VIzjeA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "definition": "540p", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o0GIEOWWEFA3NgQgERWDQEe7ALCBgtqAHBifBW/?a=1988&bti=ODszNWYuMDE6&&bt=1147&eid=20480&ft=I~da4o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmNWUzOWc3N2YzPDg2OGU6OUBpM2V1dnA5cjQzZDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiM0YzIzNV8tX2AxMGNfLjVeYSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&expire=1788851238&l=202609061507101C828FF3E79634867AA2&ply_type=2&policy=2&signature=1450b97fe7b95e3e76b0cec8f6a40778&tk=tt_chain_token&btag=e000b0000", "duration": 8, "dynamicCover": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/ocfRIEg3WtEaK5iALHBnIveCgBFVBqAAg7DQPE~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=WAsJbzS8uz%2B7mJgSUeBF8aP%2BAbc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "encodeUserTag": "", "encodedType": "normal", "format": "mp4", "height": 1024, "id": "7674144007525534983", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oof9AMEABCBEW2g3tZDWQqQrgQKgeERlAFsEUi~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=g6Wt1%2Fx7hq2Qs1VtgOb60UCJfHc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/o8WgIQW3EDAVCiC1QAFtBRqIiE7gLBhgEefyAE/?a=1988&bti=ODszNWYuMDE6&&bt=472&ft=I~da4o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=PDpmODhkZGg3NDY0PGk6NkBpM2V1dnA5cjQzZDMzODczNEBjMy8vNjZiNS0xX2FgMTQuYSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&expire=1788851238&l=202609061507101C828FF3E79634867AA2&ply_type=2&policy=2&signature=3e87a3b80737de94702a1d5bd5cac325&tk=tt_chain_token&btag=e000b0000", "ratio": "540p", "size": 526600, "subtitleInfos": [ { "Format": "webvtt", "LanguageCodeName": "eng-US", "LanguageID": "2", "Size": 163, "Source": "ASR", "Url": "https://v16-webapp.tiktok.com/fd7433fbedd4d5dfba5e05eb96df7505/6a9fb426/video/tos/alisg/tos-alisg-pv-0037/dbc0ef443af147b6ad6057e6ef221d7c/?a=1988&bti=ODszNWYuMDE6&&bt=3276&ft=IecA0o62D12NvllDEzIxR1UjblBF-UjNSEopiX&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM2V1dnA5cjQzZDMzODczNEBpM2V1dnA5cjQzZDMzODczNEBjRl5Nc3FePmJKYSNvYF90aHFmOiNfal9xMmQ0ZC1hLS1kMS1zYSNfal9xMmQ0ZC1hLS1kMS1zcw%3D%3D&l=202609061507101C828FF3E79634867AA2&btag=e00070000", "UrlExpire": 1788851238, "Version": "1:big_caption" } ], "videoID": "v10044g50000da00g17og65mtsbrmbb0", "videoQuality": "lowest", "volumeInfo": { "Loudness": -18.9, "Peak": 0.48978 }, "width": 576, "zoomCover": { "240": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/oMQeAq2EiBA55gRit9QAGFEBgCDGWgCk3fsEVQ~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=9knTZeKroWY%2BqaUpViTvunp3YXc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oMQeAq2EiBA55gRit9QAGFEBgCDGWgCk3fsEVQ~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=d1Rr6jvyfHg9JwV99Rf7LNvSVCY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0037/oMQeAq2EiBA55gRit9QAGFEBgCDGWgCk3fsEVQ~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=4RztT4vDjPgipT4QevhQXlxFoZo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oMQeAq2EiBA55gRit9QAGFEBgCDGWgCk3fsEVQ~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=3%2BArOF15Xsr1ZAOJo5StJwfNBYY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } ], "log_pb": { "impr_id": "202609061507101C828FF3E79634867AA2" }, "statusCode": 0, "status_code": 0, "status_msg": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/search/user": { "get": { "tags": [ "Search" ], "summary": "Search Users", "description": "Search users by keyword.\n\nReturns user_list[] (user object + follower/following stats),\nranked by TikTok relevance. offset pagination (0, 20, 40, ...).", "operationId": "searchUsers", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword (URL-encode non-ASCII characters).", "title": "Keyword", "default": "cat", "example": "cat" }, "description": "Search keyword (URL-encode non-ASCII characters)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Skip the first N results - search endpoints page by offset.", "default": 0, "title": "Offset" }, "description": "Skip the first N results - search endpoints page by offset." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "type": 1, "user_list": [ { "user_info": { "uid": "6638537822050451457", "nickname": "CatĐángYêu❀", "signature": "✨cô gái thích làm phim ngắn✨\nContact Job: bookcatdy@gmail.com", "avatar_thumb": { "uri": "tos-alisg-avt-0068/234cf0109d39e6ddc40012880d73eae6", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/234cf0109d39e6ddc40012880d73eae6~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=5f60b17a&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1788764400&x-signature=aEYmhopzDaPRvjmLET0pj%2FXoO7Y%3D" ], "width": 720, "height": 720, "url_prefix": null }, "follow_status": 0, "follower_count": 4100000, "total_favorited": 202036238, "custom_verify": "Verified account", "unique_id": "catbaby0", "room_id": 0, "enterprise_verify_reason": "", "followers_detail": null, "platform_sync_info": null, "geofencing": null, "cover_url": null, "item_list": null, "type_label": null, "ad_cover_url": null, "relative_users": null, "cha_list": null, "sec_uid": "MS4wLjABAAAAbUdl00hcU-Z_y7Q9stu7Od-ZJzGCRY7XsRRcEUANrt3kADTlnAxMXwnXBf6hS1DB", "need_points": null, "homepage_bottom_toast": null, "can_set_geofencing": null, "white_cover_url": null, "user_tags": null, "bold_fields": null, "search_highlight": null, "mutual_relation_avatars": null, "room_id_str": "0", "events": null, "advance_feature_item_order": null, "advanced_feature_info": null, "user_profile_guide": null, "shield_edit_field_info": null, "can_message_follow_status_list": null, "account_labels": null }, "position": null, "uniqid_position": null, "effects": null, "musics": null, "items": null, "mix_list": null, "challenges": null } ], "challenge_list": null, "music_list": null, "cursor": 10, "has_more": 1, "status_code": 0, "qc": "", "rid": "202609061507115BA5054875B0A2DFD99C", "log_pb": { "impr_id": "202609061507115BA5054875B0A2DFD99C" }, "extra": { "now": 1788678432000, "logid": "202609061507115BA5054875B0A2DFD99C", "fatal_item_ids": [], "search_request_id": "", "server_stream_time": 618, "api_debug_info": null }, "input_keyword": "cat", "global_doodle_config": { "keyword": "cat", "display_filter_bar": 1, "new_source": "", "search_channel": "tiktok_user", "tns_search_result": "Pass", "hide_results": false, "feedback_survey": null, "hit_shark": false, "hit_dolphin": false }, "feedback_type": "user" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/search/video": { "get": { "tags": [ "Search" ], "summary": "Search Videos", "description": "Search videos (posts) by keyword.\n\nReturns itemList[] of full video objects, ranked by TikTok\nrelevance. offset pagination (0, 20, 40, ...).", "operationId": "searchVideos", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword (URL-encode non-ASCII characters).", "title": "Keyword", "default": "cat", "example": "cat" }, "description": "Search keyword (URL-encode non-ASCII characters)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Skip the first N results - search endpoints page by offset.", "default": 0, "title": "Offset" }, "description": "Skip the first N results - search endpoints page by offset." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "status_code": 0, "item_list": [ { "id": "7556191047316032823", "desc": "Cat core #cat #cats #funnypets #funnyanimals #catlover #foryoupage #fyp #viral ", "createTime": 1759312979, "video": { "id": "7556191047316032823", "height": 1024, "width": 576, "duration": 94, "ratio": "540p", "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o4teD8BtMcdGXzeifzQe9vgK5KQgwgjAOqN3fA~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=qd6p2HnflRbqFeHQUfJ6euX5msA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/ocCBtfg8NGQheQcTKeM5jfX9OFs5AAOgwXfGgi~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=MNEAYLuT2t4MyyrwXZ3X8bxkG04%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/oEG5GngfQS9wKRYiQfW5IcAnCNLFWQeWtAfGfI~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=MSVoAt7hEyMN7XsuRh%2FSgwJ7XkM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ok9wQXMuNicveRnfUzQgtfKAeAjANOme5G8gB9/?a=1988&bti=ODszNWYuMDE6&&bt=834&ft=-Csk_mH1PD12NEYPJn-Ux912aY6e3wv25ycAp&mime_type=video_mp4&rc=OTU7ODxoM2c5ZmZlaDRpZkBpM2p4NHM5cnlpNjMzZzczNEA1M2MzLS0zXmAxYTNeNjE2YSNgZWFvMmRza2JhLS1kMS9zcw%3D%3D&expire=1788851327&l=2026090615071260F4B6AC68A81F7D63F1&ply_type=2&policy=2&signature=889d1f5f10f60503ae93ea38c57c2938&tk=tt_chain_token&btag=e00090000", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/owEfgQgwfMAGftoN19XOcNGAeijABKJ5Re8p5Q/?a=1988&bti=ODszNWYuMDE6&&bt=882&ft=-Csk_mH1PD12NEYPJn-Ux912aY6e3wv25ycAp&mime_type=video_mp4&rc=NTc7ZGdlODw3NmRnOmQ3Z0BpM2p4NHM5cnlpNjMzZzczNEBeNC5jNGJhXjExXjA2YWBhYSNgZWFvMmRza2JhLS1kMS9zcw%3D%3D&expire=1788851327&l=2026090615071260F4B6AC68A81F7D63F1&ply_type=2&policy=2&signature=30b22324cfb5153c117dea1ca123425d&tk=tt_chain_token&btag=e00090000", "bitrate": 854381, "encodedType": "normal", "format": "mp4", "videoQuality": "normal", "encodeUserTag": "", "codecType": "h264", "definition": "540p", "bitrateInfo": [ { "GearName": "normal_540_0", "Bitrate": 854381, "QualityType": 20, "PlayAddr": { "Uri": "v12044gd0000d3efnvvog65pr1duhgc0", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ok9wQXMuNicveRnfUzQgtfKAeAjANOme5G8gB9/?a=1988&bti=ODszNWYuMDE6&&bt=834&ft=-Csk_mH1PD12NEYPJn-Ux912aY6e3wv25ycAp&mime_type=video_mp4&rc=OTU7ODxoM2c5ZmZlaDRpZkBpM2p4NHM5cnlpNjMzZzczNEA1M2MzLS0zXmAxYTNeNjE2YSNgZWFvMmRza2JhLS1kMS9zcw%3D%3D&expire=1788851327&l=2026090615071260F4B6AC68A81F7D63F1&ply_type=2&policy=2&signature=889d1f5f10f60503ae93ea38c57c2938&tk=tt_chain_token&btag=e00090000" ], "DataSize": 10125059, "Width": 576, "Height": 1024, "UrlKey": "v12044gd0000d3efnvvog65pr1duhgc0_h264_540p_854381", "FileHash": "d4612212e123fa1a4219ea3a2352a04a", "FileCs": "c:0-77649-61b9" }, "CodecType": "h264", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 93.291, \"v960\": 94.058, \"v864\": 95.088, \"v720\": 94.883}, \"ori\": {\"v1080\": 84.845, \"v960\": 86.933, \"v864\": 88.297, \"v720\": 90.465}}}" } ], "zoomCover": { "240": "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o4teD8BtMcdGXzeifzQe9vgK5KQgwgjAOqN3fA~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=pQKHeJkzsjuDFzfp3bqO0aTD%2B3U%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o4teD8BtMcdGXzeifzQe9vgK5KQgwgjAOqN3fA~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=2dgi8EPVl2TBoBhIhK8mrHh%2F60I%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o4teD8BtMcdGXzeifzQe9vgK5KQgwgjAOqN3fA~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=WskxCjaYvhy7Df16kRaHDuK6YhE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o4teD8BtMcdGXzeifzQe9vgK5KQgwgjAOqN3fA~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=5OGiXCGFL%2BLsIOhw6evuF150EWg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "volumeInfo": { "Loudness": -16, "Peak": 0.66834 }, "size": 10125059, "VQScore": "55.78", "claInfo": { "hasOriginalAudio": true, "enableAutoCaption": true, "noCaptionReason": 3 }, "videoID": "v12044gd0000d3efnvvog65pr1duhgc0" }, "author": { "id": "7504868055664722986", "uniqueId": "funnypets_11", "nickname": "funnypets_11", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/35478600c368d3728593a333888baa75~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=7ace560e&x-expires=1788850800&x-signature=aOGx%2FPBht30IZeqpy9cCKLlhwu8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/35478600c368d3728593a333888baa75~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=20a20866&x-expires=1788850800&x-signature=ko8JYayPgygPGG53uZ6hC63eGow%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/35478600c368d3728593a333888baa75~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=57c49bec&x-expires=1788850800&x-signature=fHREOSzVz1DYxseDlNxmo%2F2Ws30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "signature": "", "verified": false, "secUid": "MS4wLjABAAAAiLBBwbJ-J8ZNs1F-Ou4pbFWPOqtaP78su_d6LQh002aZS-pvoPPEVvgMCCCfFq7O", "secret": false, "ftc": false, "relation": 0, "openFavorite": false, "commentSetting": 0, "duetSetting": 0, "stitchSetting": 0, "privateAccount": false, "isADVirtual": false, "downloadSetting": 0, "isEmbedBanned": false }, "music": { "id": "7556191673873664782", "title": "original sound", "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-v-27dcd7c799-us/ooitqJeWIcIAefmGQtAWIPLIAbAlAj5FGOOfFs/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThOVn~GXq8Zmo&mime_type=audio_mpeg&rc=anNwb3Q5cm9pNjMzZzU8NEBpanNwb3Q5cm9pNjMzZzU8NEBjNGBpMmRrbGJhLS1kMS9zYSNjNGBpMmRrbGJhLS1kMS9zcw%3D%3D&expire=1788682127&l=2026090615071260F4B6AC68A81F7D63F1&ply_type=3&policy=3&signature=0a00017b7681565d5b4eef6f99f85e00&tk=7598066736076915733&btag=e00050000", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/35478600c368d3728593a333888baa75~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=7ace560e&x-expires=1788850800&x-signature=aOGx%2FPBht30IZeqpy9cCKLlhwu8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/35478600c368d3728593a333888baa75~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=20a20866&x-expires=1788850800&x-signature=ko8JYayPgygPGG53uZ6hC63eGow%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/35478600c368d3728593a333888baa75~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=57c49bec&x-expires=1788850800&x-signature=fHREOSzVz1DYxseDlNxmo%2F2Ws30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "authorName": "funnypets_11", "original": true, "private": false, "duration": 94, "isCopyrighted": true, "tt2dsp": {} }, "challenges": [ { "id": "7551", "title": "cat", "desc": "", "profileThumb": "https://p16-common-sign.tiktokcdn.com/musically-maliva-obj/2e13829d6e1816708244b2bc8b905c51~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=b6GR0lwCPjM%2FR3GP4kIws8K%2Fq2A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "profileMedium": "https://p16-common-sign.tiktokcdn.com/musically-maliva-obj/2e13829d6e1816708244b2bc8b905c51~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=b6GR0lwCPjM%2FR3GP4kIws8K%2Fq2A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "profileLarger": "https://p16-common-sign.tiktokcdn.com/musically-maliva-obj/2e13829d6e1816708244b2bc8b905c51~tplv-tiktokx-origin.image?dr=14566&x-expires=1788699600&x-signature=b6GR0lwCPjM%2FR3GP4kIws8K%2Fq2A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my", "coverThumb": "", "coverMedium": "", "coverLarger": "" } ], "stats": { "diggCount": 159200, "shareCount": 37600, "commentCount": 282, "playCount": 700900, "collectCount": 16000 }, "originalItem": false, "officalItem": false, "textExtra": [ { "awemeId": "", "start": 9, "end": 13, "hashtagName": "cat", "hashtagId": "7551", "type": 1, "isCommerce": false, "subType": 0 } ], "secret": false, "forFriend": false, "digged": false, "itemCommentStatus": 0, "authorStats": { "followingCount": 34, "followerCount": 51300, "heartCount": 4100000, "videoCount": 199, "diggCount": 325, "heart": 4100000, "friendCount": 0 }, "privateItem": false, "duetEnabled": true, "stitchEnabled": true, "shareEnabled": true, "isAd": false, "duetDisplay": 0, "stitchDisplay": 0, "contents": [ { "desc": "Cat core #cat #cats #funnypets #funnyanimals #catlover #foryoupage #fyp #viral ", "textExtra": [ { "awemeId": "", "start": 9, "end": 13, "hashtagName": "cat", "hashtagId": "7551", "type": 1, "isCommerce": false, "subType": 0 } ] } ], "diversificationId": 10019, "collected": false, "item_control": { "can_repost": true }, "statsV2": { "diggCount": "159200", "shareCount": "37600", "commentCount": "282", "playCount": "700900", "collectCount": "16032", "repostCount": "0" }, "AIGCDescription": "", "backendSourceEventTracking": "", "CategoryType": 113, "textLanguage": "en", "textTranslatable": true, "authorStatsV2": { "followingCount": "34", "followerCount": "51300", "heartCount": "4100000", "videoCount": "199", "diggCount": "325", "heart": "4100000", "friendCount": "0" }, "isReviewing": false, "creatorAIComment": { "hasAITopic": false, "topicName": "Topics", "eligibleVideo": true, "topicDescription": "Most frequently discussed topics", "topicSubDescription": "Know which discussions are trending among viewers with this list of AI-summarized topics.", "copyright": "Summarized by AI. Mistakes are possible.", "notEligibleReason": 0 }, "IsHDBitrate": false } ], "has_more": 1, "cursor": 5, "extra": { "now": 1788678433000, "logid": "2026090615071260F4B6AC68A81F7D63F1", "fatal_item_ids": [], "search_request_id": "", "api_debug_info": null }, "log_pb": { "impr_id": "2026090615071260F4B6AC68A81F7D63F1" }, "backtrace": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/search/general": { "get": { "tags": [ "Search" ], "summary": "General Search", "description": "General search: users, hashtags, videos and music in one call.\n\nReturns typed result blocks (user_list, challenge_list,\nitemList, music_list) for building a search-results page.", "operationId": "generalSearch", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword (URL-encode non-ASCII characters).", "title": "Keyword", "default": "cat", "example": "cat" }, "description": "Search keyword (URL-encode non-ASCII characters)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Skip the first N results - search endpoints page by offset.", "default": 0, "title": "Offset" }, "description": "Skip the first N results - search endpoints page by offset." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "status_code": 0, "data": [ { "type": 1, "item": { "id": "7526177557901790519", "desc": "Orange cat have own vegetable garden #orangecat #cat #cutecat #petsoftiktok #aicat #funnycat #cute #unitedstates #pet #animals ", "createTime": 1752324841, "video": { "id": "7526177557901790519", "height": 1024, "width": 576, "duration": 30, "ratio": "540p", "cover": "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o8Ulueg8DEWcEduoAcBRIWEyfrENPBDSdD9RcF~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=iyEcS1VNDJaqnnZjSCkYptuc%2Bxs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/oEcR9cENDXExuySuEurUWdgIDfARFDBdeBEolI~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=0XIvgFvqA9wX6fUturdv%2BJUxOpw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "dynamicCover": "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/oMSDcQuqExXCIuFgovdADWlfEr9RBUEcyIDKue~tplv-tiktokx-origin.image?dr=14575&x-expires=1788850800&x-signature=3P3GL5OSrgZkr8NsM%2BVJbHeKg1U%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIlQSIWFgAr8DE96RFfuloDBLHcu4EE8vfDUgy/?a=1988&bti=ODszNWYuMDE6&&bt=1073&ft=-Csk_mH1PD12NBYPJn-UxBT2aY6e3wv25dcAp&mime_type=video_mp4&rc=ZTlnN2czaGhkN2dkNzw2OEBpM3c6OHg5cm84NDMzZzczNEA1Ll82MS4vXzIxMDBgYGMyYSNicGxlMmQ0aW1hLS1kMS9zcw%3D%3D&expire=1788851265&l=20260906150714096FA7DBBA9868B5354C&ply_type=2&policy=2&signature=7760f8d7d23822cfda2b769c89241174&tk=tt_chain_token&btag=e00088000", "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ooADQvdyKEoEfBqE9JDleIU0ScWRErFgI4DEcu/?a=1988&bti=ODszNWYuMDE6&&bt=1109&ft=-Csk_mH1PD12NBYPJn-UxBT2aY6e3wv25dcAp&mime_type=video_mp4&rc=NTo0Z2k2OmU6OGU6OTo1NEBpM3c6OHg5cm84NDMzZzczNEA0LmAxNWNiXmExXjBgX18xYSNicGxlMmQ0aW1hLS1kMS9zcw%3D%3D&expire=1788851265&l=20260906150714096FA7DBBA9868B5354C&ply_type=2&policy=2&signature=f731389f95a3cba2afca4d05a4bc9815&tk=tt_chain_token&btag=e00088000", "bitrate": 1098997, "encodedType": "normal", "format": "mp4", "videoQuality": "normal", "encodeUserTag": "", "codecType": "h264", "definition": "540p", "bitrateInfo": [ { "GearName": "adapt_lowest_1080_1", "Bitrate": 1181646, "QualityType": 2, "PlayAddr": { "Uri": "v12044gd0000d1p5ll7og65uh5o7ste0", "UrlList": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oAO5gwLhLckpg1eKHAGARW56jJQAeCXIRLIHeB/?a=1988&bti=ODszNWYuMDE6&&bt=1153&ft=-Csk_mH1PD12NBYPJn-UxBT2aY6e3wv25dcAp&mime_type=video_mp4&rc=ZDozZTZpaTZpPGQ4Zmk4M0BpM3c6OHg5cm84NDMzZzczNEAyMDZfLi0wXy4xLmNeLjUvYSNicGxlMmQ0aW1hLS1kMS9zcw%3D%3D&expire=1788851265&l=20260906150714096FA7DBBA9868B5354C&ply_type=2&policy=2&signature=fa438a94c1bc8836b77f3722f8555450&tk=tt_chain_token&btag=e00088000" ], "DataSize": 4503106, "Width": 1080, "Height": 1920, "UrlKey": "v12044gd0000d1p5ll7og65uh5o7ste0_bytevc1_1080p_1181646", "FileHash": "b7e435f6faf240bdbf68ceca3a463eef", "FileCs": "c:0-26826-0ac3" }, "CodecType": "h265_hvc1", "MVMAF": "{\"v2.0\": {\"srv1\": {\"v1080\": 97.534, \"v960\": 98.176, \"v864\": 98.752, \"v720\": 99.27}, \"ori\": {\"v1080\": 92.028, \"v960\": 93.285, \"v864\": 94.073, \"v720\": 95.25}}}" } ], "zoomCover": { "240": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o8Ulueg8DEWcEduoAcBRIWEyfrENPBDSdD9RcF~tplv-photomode-zoomcover:240:240.jpeg?dr=14555&x-expires=1788850800&x-signature=UyzQ0XzYlbHp247xuj1sSlgKPbM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "480": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o8Ulueg8DEWcEduoAcBRIWEyfrENPBDSdD9RcF~tplv-photomode-zoomcover:480:480.jpeg?dr=14555&x-expires=1788850800&x-signature=tT3q%2BjEqxC4mOgdmVbk52Gdi18A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "720": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o8Ulueg8DEWcEduoAcBRIWEyfrENPBDSdD9RcF~tplv-photomode-zoomcover:720:720.jpeg?dr=14555&x-expires=1788850800&x-signature=kmiStTcbJRXM2t0cUwFGMLnSEBw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1", "960": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/o8Ulueg8DEWcEduoAcBRIWEyfrENPBDSdD9RcF~tplv-photomode-zoomcover:960:960.jpeg?dr=14555&x-expires=1788850800&x-signature=L854d8V%2F0d2rjdYRwzFtGUyUEes%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "volumeInfo": { "Loudness": -13.2, "Peak": 1 }, "size": 4188141, "VQScore": "77.43", "claInfo": { "hasOriginalAudio": true, "enableAutoCaption": true, "noCaptionReason": 3 }, "videoID": "v12044gd0000d1p5ll7og65uh5o7ste0" }, "author": { "id": "7522816599792911373", "uniqueId": "catsnation2", "nickname": "CatsNation", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/9053aaf619aa0c836dcd2d35f403cb93~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=9dffffb8&x-expires=1788850800&x-signature=poeD12167MN74JpsyhPrjT%2FDir4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/9053aaf619aa0c836dcd2d35f403cb93~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=6e83373b&x-expires=1788850800&x-signature=zn4PXkdpEQevc8nVMGpBzYzr6II%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/9053aaf619aa0c836dcd2d35f403cb93~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=70a8910d&x-expires=1788850800&x-signature=bJepLGOBWyVtBSAEXsT8ZjKmiGY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my", "signature": "😽 My name is kiki \n🍜 Loves food&cooking\nLearn how to create-----DM me💕", "verified": false, "secUid": "MS4wLjABAAAAwxaxQbLytifQSGxEbj8DF-cinRMH9MERPohr5U6__UktiJUFakoKnRejQcWyEJan", "secret": false, "ftc": false, "relation": 0, "openFavorite": false, "commentSetting": 0, "duetSetting": 0, "stitchSetting": 0, "privateAccount": false, "isADVirtual": false, "downloadSetting": 0, "isEmbedBanned": false }, "music": { "id": "7439765609816590337", "title": "Meow number 16 - The kitten's nose", "playUrl": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oUhEvWg4QPptQHPBhfNDfBKZuACFgL1gC8AnYc", "coverThumb": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/ogDNSSfKArRSnFAtfv2BCWQYESIBRIVgZKCA2S.jpeg", "coverMedium": "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/ogDNSSfKArRSnFAtfv2BCWQYESIBRIVgZKCA2S.jpeg", "coverLarge": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/ogDNSSfKArRSnFAtfv2BCWQYESIBRIVgZKCA2S.jpeg", "authorName": "AtilaKw", "original": false, "private": false, "duration": 70, "album": "Meow number 16 - The kitten's nose", "isCopyrighted": false, "tt2dsp": { "tt_to_dsp_song_infos": [ { "platform": 1, "song_id": "6781466354", "token": { "apple_music_token": { "developer_token": "eyJhbGciOiJFUzI1NiIsImtpZCI6Ikc2Q0dLMjdWQzMifQ.eyJleHAiOjE3ODg4NzkxMDEsImlhdCI6MTc4ODYxOTkwMSwiaXNzIjoiTUo3OTdEOFU2RiJ9.ZrMZQJaCF8UksTbGrBjtUcMn3p58uESnwcNaGfEFdZWAbEMbEPKerkVe66NcflZBJhkDAUE5vf0hBIQc4jSR1Q" } }, "meta_song_id": "7439763343525103617" }, { "platform": 3, "song_id": "5RegavLk6a8U3okQjXuVuq", "meta_song_id": "7439763343525103617" } ] } }, "challenges": [ { "id": "3666453", "title": "orangecat", "desc": "", "profileThumb": "", "profileMedium": "", "profileLarger": "", "coverThumb": "", "coverMedium": "", "coverLarger": "" } ], "stats": { "diggCount": 18500, "shareCount": 1005, "commentCount": 404, "playCount": 652300, "collectCount": 1177 }, "originalItem": false, "officalItem": false, "textExtra": [ { "awemeId": "", "start": 37, "end": 47, "hashtagName": "orangecat", "hashtagId": "3666453", "type": 1, "isCommerce": false, "subType": 0 } ], "secret": false, "forFriend": false, "digged": false, "itemCommentStatus": 0, "authorStats": { "followingCount": 8, "followerCount": 5264, "heartCount": 51700, "videoCount": 25, "diggCount": 20, "heart": 51700, "friendCount": 0 }, "privateItem": false, "duetEnabled": true, "stitchEnabled": true, "shareEnabled": true, "isAd": false, "duetDisplay": 0, "stitchDisplay": 0, "contents": [ { "desc": "Orange cat have own vegetable garden #orangecat #cat #cutecat #petsoftiktok #aicat #funnycat #cute #unitedstates #pet #animals ", "textExtra": [ { "awemeId": "", "start": 37, "end": 47, "hashtagName": "orangecat", "hashtagId": "3666453", "type": 1, "isCommerce": false, "subType": 0 } ] } ], "diversificationId": 10019, "collected": false, "item_control": { "can_repost": true }, "aigcLabelType": 1, "statsV2": { "diggCount": "18500", "shareCount": "1005", "commentCount": "404", "playCount": "652300", "collectCount": "1177", "repostCount": "0" }, "AIGCDescription": "", "backendSourceEventTracking": "", "CategoryType": 113, "textLanguage": "en", "textTranslatable": true, "authorStatsV2": { "followingCount": "8", "followerCount": "5264", "heartCount": "51700", "videoCount": "25", "diggCount": "20", "heart": "51700", "friendCount": "0" }, "isReviewing": false, "creatorAIComment": { "hasAITopic": false, "eligibleVideo": false, "notEligibleReason": 211 }, "IsHDBitrate": false }, "common": { "doc_id_str": "7526177557901790519" } } ], "qc": "", "cursor": 5, "has_more": 1, "ad_info": {}, "extra": { "now": 1788678435000, "logid": "20260906150714096FA7DBBA9868B5354C", "fatal_item_ids": [], "search_request_id": "", "api_debug_info": null }, "log_pb": { "impr_id": "20260906150714096FA7DBBA9868B5354C" }, "global_doodle_config": { "feedback_survey": null }, "backtrace": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/search/photo": { "get": { "tags": [ "Search" ], "summary": "Search Photos", "description": "Search photo posts (image carousels) by keyword.\n\nReturns itemList[] of photo posts (imagePost struct instead of\nvideo). offset pagination (0, 20, 40, ...).", "operationId": "searchPhotos", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword (URL-encode non-ASCII characters).", "title": "Keyword", "default": "cat", "example": "cat" }, "description": "Search keyword (URL-encode non-ASCII characters)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Skip the first N results - search endpoints page by offset.", "default": 0, "title": "Offset" }, "description": "Skip the first N results - search endpoints page by offset." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "status_code": 0, "has_more": 0, "cursor": 5, "extra": { "now": 1788678436000, "logid": "202609061507153AA509D7D25D6BCEEF04", "fatal_item_ids": [], "search_request_id": "", "api_debug_info": null }, "log_pb": { "impr_id": "202609061507153AA509D7D25D6BCEEF04" }, "search_nil_info": { "search_nil_type": "", "is_load_more": "first_flush", "search_nil_item": "federation_empty", "text_type": 10 }, "backtrace": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/search/live": { "get": { "tags": [ "Search" ], "summary": "Search Live Streams", "description": "Search live streams by keyword.\n\nReturns live_room_list[] with room_id, title, user_count and the\nhost's user object. Rooms end quickly - treat room_id as\nshort-lived.", "operationId": "searchLiveStreams", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword (URL-encode non-ASCII characters).", "title": "Keyword", "default": "music", "example": "music" }, "description": "Search keyword (URL-encode non-ASCII characters)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Skip the first N results - search endpoints page by offset.", "default": 0, "title": "Offset" }, "description": "Skip the first N results - search endpoints page by offset." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Page size, 1-30. Default 20.", "default": 20, "title": "Count" }, "description": "Page size, 1-30. Default 20." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "status_code": 0, "data": [ { "live_info": { "raw_data": "{\"id\":7682229001867332365,\"id_str\":\"7682229001867332365\",\"status\":2,\"owner_user_id\":6892959113391784965,\"title\":\"Singing Battle 🎤 $10,000\",\"user_count\":574,\"client_version\":13502,\"cover\":{\"url_list\":[\"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/bcef8b56ccfe68eb00f7cc865a64110a~tplv-tiktokx-cropcenter:720:720.webp?dr=14579\\u0026refresh_token=dd044449\\u0026x-expires=1788850800\\u0026x-s...(truncated)", "room_info": { "has_commerce_goods": false, "is_battle": false } } } ], "has_more": 1, "cursor": 5, "extra": { "now": 1788678437000, "logid": "2026090615071690912AFAD70695814759", "fatal_item_ids": [], "search_request_id": "", "api_debug_info": null }, "log_pb": { "impr_id": "2026090615071690912AFAD70695814759" }, "backtrace": "" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/search/suggest": { "get": { "tags": [ "Search" ], "summary": "Search Suggestions", "description": "Get search suggestions (autocomplete) for a keyword prefix.\n\nReturns a ranked list of related search terms.", "operationId": "searchSuggestions", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Partial keyword to autocomplete.", "title": "Keyword", "default": "cat", "example": "cat" }, "description": "Partial keyword to autocomplete." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "example": { "data": [ { "word": "Hey Its Me Its Verity Song Trend", "group_id": "2756614325429141815", "word_type": "2" } ], "status_code": 0, "status_msg": "", "log_id": "20260906150717F664CECBA34822AD667B" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/download/video": { "get": { "tags": [ "Download" ], "summary": "Download Video or Music", "description": "Download a post's media as a file stream.\n\nPass either videoId (numeric) or url (video page URL / vm.tiktok\nshort link). Options: musicOnly=true streams the soundtrack as\nMP3; watermark=true prefers the watermarked video variant\n(default is watermark-free when available); quality picks the\nvideo resolution from bitrateInfo - \"best\" (highest available,\ndefault), \"worst\", or a height cap like \"1080\"/\"720\"/\"540\".\nResponds with the media file (video/mp4 or audio/mpeg); photo\nposts have no video stream - fetch image URLs from\n/v1/post/detail instead. Actual gear served is echoed in the\nX-Gw-Quality / X-Gw-Resolution / X-Gw-Codec response headers.\n\n429s: \"download_concurrency_limit\" = too many streams in flight,\nretry after a few seconds; \"monthly_bandwidth_exceeded\" = the\ngateway's monthly egress budget is exhausted, downloads resume\non the 1st of next month (UTC) while metadata endpoints stay up.", "operationId": "downloadVideoOrMusic", "parameters": [ { "name": "videoId", "in": "query", "required": false, "schema": { "description": "Numeric video id - one of videoId/url is required.", "title": "Videoid", "type": "string", "default": "7681719358225239326", "example": "7681719358225239326" }, "description": "Numeric video id - one of videoId/url is required." }, { "name": "url", "in": "query", "required": false, "schema": { "description": "Video page URL or vm.tiktok.com short link - one of videoId/url is required.", "title": "Url", "type": "string" }, "description": "Video page URL or vm.tiktok.com short link - one of videoId/url is required." }, { "name": "musicOnly", "in": "query", "required": false, "schema": { "type": "boolean", "description": "true = stream the soundtrack as MP3 instead of the video.", "default": false, "title": "Musiconly" }, "description": "true = stream the soundtrack as MP3 instead of the video." }, { "name": "watermark", "in": "query", "required": false, "schema": { "type": "boolean", "description": "true = prefer the watermarked variant (default: watermark-free when available).", "default": false, "title": "Watermark" }, "description": "true = prefer the watermarked variant (default: watermark-free when available)." }, { "name": "quality", "in": "query", "required": false, "schema": { "type": "string", "description": "Video quality: \"best\" (default), \"worst\", or a height cap like \"1080\"/\"720\"/\"540\".", "default": "best", "title": "Quality" }, "description": "Video quality: \"best\" (default), \"worst\", or a height cap like \"1080\"/\"720\"/\"540\"." } ], "responses": { "200": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } }, "tags": [ { "name": "User" }, { "name": "Post" }, { "name": "Challenge" }, { "name": "Music" }, { "name": "Collection" }, { "name": "Place" }, { "name": "Drama" }, { "name": "Feed" }, { "name": "Search" }, { "name": "Download" } ] }