{ "openapi": "3.1.0", "info": { "title": "Tikfly API - Unoffical Tiktok API", "description": "Tikfly API Documentation - Unoffical Tiktok API for scalable access without the usual limitations", "version": "1.0.0" }, "servers": [ { "url": "https://tiktok-api23.p.rapidapi.com", "description": "RapidAPI" } ], "components": { "securitySchemes": { "apiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-rapidapi-key", "description": "Rapid API Key. [How can I get Rapid API Key?](https://docs.tikfly.io/getting-started/quickstart)" } }, "schemas": { } }, "paths": { "/api/user/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "userInfo": { "type": "object", "properties": { "stats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "statsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "user": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 }, "bioLink": { "type": "object", "properties": { "link": { "type": "string", "description": "The URL linked in the user’s bio", "example": "taylorswift.com" }, "risk": { "type": "number", "description": "Risk score associated with the bio link", "example": 0 } } }, "canExpPlaylist": { "type": "boolean", "description": "", "example": true }, "commerceUserInfo": { "type": "object", "properties": { "commerceUser": { "type": "boolean", "description": "Indicates if the user is registered as a commerce account", "example": false }, "downLoadLink": { "type": "object", "description": "", "example": { } }, "category": { "type": "string", "description": "Category of the user’s commerce activity", "example": "Media & Entertainment" }, "categoryButton": { "type": "boolean", "description": "", "example": false } } }, "followingVisibility": { "type": "number", "description": "Visibility setting of the user’s following list", "example": 1 }, "isEmbedBanned": { "type": "boolean", "description": "Indicates whether embedding of this profile on external sites is banned", "example": false }, "nickNameModifyTime": { "type": "number", "description": "Unix timestamp of the last time the user’s nickname was modified", "example": 1629723423 }, "profileEmbedPermission": { "type": "number", "description": "Profile embedding permission status", "example": 1 }, "profileTab": { "type": "object", "description": "Additional profile tab configuration structure", "example": { } } } } } }, "statusCode": { "type": "number", "description": "Status Code\n - 0: Success\n - 10221: Not found\n ", "example": 0 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserInfo", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "uniqueId", "schema": { "type": "string", "minLength": 1, "description": "Unique ID", "example": "taylorswift" }, "required": true } ], "summary": "Get User Info", "description": "Get User Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/info-with-region": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "userInfo": { "type": "object", "properties": { "user": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 }, "bioLink": { "type": "object", "properties": { "link": { "type": "string", "description": "The URL linked in the user’s bio", "example": "taylorswift.com" }, "risk": { "type": "number", "description": "Risk score associated with the bio link", "example": 0 } } }, "canExpPlaylist": { "type": "boolean", "description": "", "example": true }, "commerceUserInfo": { "type": "object", "properties": { "commerceUser": { "type": "boolean", "description": "Indicates if the user is registered as a commerce account", "example": false }, "downLoadLink": { "type": "object", "description": "", "example": { } }, "category": { "type": "string", "description": "Category of the user’s commerce activity", "example": "Media & Entertainment" }, "categoryButton": { "type": "boolean", "description": "", "example": false } } }, "followingVisibility": { "type": "number", "description": "Visibility setting of the user’s following list", "example": 1 }, "isEmbedBanned": { "type": "boolean", "description": "Indicates whether embedding of this profile on external sites is banned", "example": false }, "nickNameModifyTime": { "type": "number", "description": "Unix timestamp of the last time the user’s nickname was modified", "example": 1629723423 }, "profileEmbedPermission": { "type": "number", "description": "Profile embedding permission status", "example": 1 }, "profileTab": { "type": "object", "description": "Additional profile tab configuration structure", "example": { } }, "shortId": { "type": "string", "description": "", "example": "" }, "createTime": { "type": "number", "description": "Unix timestamp representing when the entity was created", "example": 1628514847 }, "roomId": { "type": "string", "description": "ID for the account live room", "example": "" }, "uniqueIdModifyTime": { "type": "number", "description": "Unix timestamp of the last modification of the unique ID", "deprecated": true, "example": 0 }, "recommendReason": { "type": "string", "description": "Reason provided by Tiktok system for recommending this account", "example": "" }, "language": { "type": "string", "description": "Primary language associated with the account", "example": "en" }, "eventList": { "type": "array", "items": { "type": "object" }, "description": "", "example": [] }, "suggestAccountBind": { "type": "boolean", "description": "", "example": false }, "isOrganization": { "type": "number", "description": "Indicates whether the account represents an organization", "example": 1 } } }, "stats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "statsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" } } }, "statusCode": { "type": "number", "description": "Status Code\n - 0: Success\n - 10221: Not found\n ", "example": 0 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserInfo-with-region", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "uniqueId", "schema": { "type": "string", "minLength": 1, "description": "Unique ID", "example": "taylorswift" }, "required": true } ], "summary": "Get User Info v2", "description": "Get User Info v2", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/info-by-id": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "user": { "type": "object", "properties": { "account_type": { "type": "number", "description": "", "example": 0 }, "avatar_300x300": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null } } }, "avatar_larger": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null } } }, "avatar_medium": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null } } }, "avatar_thumb": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null } } }, "commerce_user_level": { "type": "number", "description": "", "example": 0 }, "custom_verify": { "type": "string", "description": "", "example": "verified account" }, "enterprise_verify_reason": { "type": "string", "description": "", "example": "" }, "follow_status": { "type": "number", "description": "", "example": 0 }, "follower_count": { "type": "number", "description": "Total number of users following this account", "example": 33265168 }, "follower_status": { "type": "number", "description": "", "example": 0 }, "following_count": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "original_musician": { "type": "object", "properties": { "digg_count": { "type": "number", "description": "", "example": 0 }, "music_count": { "type": "number", "description": "", "example": 7830 }, "music_used_count": { "type": "number", "description": "", "example": 0 }, "new_release_clip_ids": { "type": "null", "description": "", "example": null } } }, "room_id": { "type": "number", "description": "ID for the account live room", "example": 0 }, "sec_uid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "number", "description": "Indicates whether the account is set to private", "example": 0 }, "short_id": { "type": "string", "description": "", "example": "0" }, "show_favorite_list": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "tab_settings": { "type": "object", "properties": { "private_tab": { "type": "object", "properties": { "private_tab_style": { "type": "number", "description": "", "example": 1 }, "show_private_tab": { "type": "boolean", "description": "", "example": false } } } } }, "total_favorited": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263480662 }, "uid": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "unique_id": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verification_type": { "type": "number", "description": "", "example": 1 }, "with_commerce_entry": { "type": "boolean", "description": "", "example": false } } }, "status_code": { "type": "number", "description": " Status Code\n - 0: Success\n - 3170: Not found\n - 3002334: Not found\n ", "example": 0 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserInfo-by-id", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "userId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Either userId or secUid must be provided (only one is required)", "example": "6881290705605477381" } }, { "in": "query", "name": "secUid", "schema": { "type": "string", "description": "Either userId or secUid must be provided (only one is required)", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" } } ], "summary": "Get User Info by ID", "description": "Get User Info by ID", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "1665126038000" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserPosts", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "minLength": 1, "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 35, "description": "The number of results to be returned. The default and maximum value is 35", "example": 35 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Posts", "description": "Get User Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/popular-posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "1665126038000" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserPopular-posts", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "minLength": 1, "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 35, "description": "The number of results to be returned. The default and maximum value is 35", "example": 35 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Popular Posts", "description": "Get User Popular Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/oldest-posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "1665126038000" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserOldest-posts", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "minLength": 1, "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 35, "description": "The number of results to be returned. The default and maximum value is 35", "example": 35 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Oldest Posts", "description": "Get User Oldest Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/liked-posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "1665126038000" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } }, "description": "" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserLiked-posts", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "minLength": 1, "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 35, "description": "The number of results to be returned. The default and maximum value is 35", "example": 35 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Liked Posts", "description": "Get User Liked Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/followers": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "max_time": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 1772510719 }, "total": { "type": "number", "description": "Total number of followers the user currently has", "example": 33265126 }, "followers": { "type": "array", "items": { "type": "object", "properties": { "accept_private_policy": { "type": "boolean", "description": "Indicates whether the user has accepted the platform privacy policy.", "example": false }, "account_labels": { "type": "null", "description": "Additional labels or badges associated with the account.", "example": null }, "account_region": { "type": "string", "description": "Region associated with the user account.", "example": "" }, "ad_cover_url": { "type": "null", "description": "Advertising-related cover image metadata.", "example": null }, "advance_feature_item_order": { "type": "null", "description": "Configuration for advanced feature item ordering on the profile.", "example": null }, "advanced_feature_info": { "type": "null", "description": "Additional advanced feature configuration information.", "example": null }, "apple_account": { "type": "number", "description": "Indicates whether the account is linked to Apple (numeric flag).", "example": 0 }, "authority_status": { "type": "number", "description": "Authority or moderation status of the account.", "example": 0 }, "avatar_168x168": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_300x300": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_larger": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_medium": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_thumb": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_uri": { "type": "string", "description": "Internal CDN URI of the user avatar.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "aweme_count": { "type": "number", "description": "Total number of videos posted by the user.", "example": 1217 }, "bind_phone": { "type": "string", "description": "Masked phone number bound to the account.", "example": "" }, "bold_fields": { "type": "null", "description": "Fields highlighted in bold on the user profile.", "example": null }, "can_message_follow_status_list": { "type": "null", "description": "", "example": null }, "can_set_geofencing": { "type": "null", "description": "", "example": null }, "cha_list": { "type": "null", "description": "", "example": null }, "comment_filter_status": { "type": "number", "description": "Status of comment filtering settings.", "example": 0 }, "comment_setting": { "type": "number", "description": "Privacy setting controlling who can comment on videos.", "example": 0 }, "commerce_user_level": { "type": "number", "description": "Commerce account level indicator.", "example": 0 }, "cover_url": { "type": "array", "items": { "type": "string" }, "description": "List of profile cover image URLs.", "example": [] }, "create_time": { "type": "number", "description": "Unix timestamp when the account was created.", "example": 1593535515 }, "custom_verify": { "type": "string", "description": "Custom verification text displayed on the profile.", "example": "" }, "cv_level": { "type": "string", "description": "Creator verification level.", "example": "" }, "download_prompt_ts": { "type": "number", "description": "", "example": 0 }, "download_setting": { "type": "number", "description": "Controls who can download the user’s videos.", "example": 3 }, "duet_setting": { "type": "number", "description": "Controls who can create duet videos with this user.", "example": 3 }, "enabled_filter_all_comments": { "type": "boolean", "description": "", "example": false }, "enterprise_verify_reason": { "type": "string", "description": "Reason for enterprise account verification.", "example": "institution account" }, "events": { "type": "null", "description": "", "example": null }, "fake_data_info": { "type": "object", "description": "", "example": { } }, "favoriting_count": { "type": "number", "description": "Number of videos the user has favorited.", "example": 249 }, "fb_expire_time": { "type": "number", "description": "", "example": 0 }, "follower_count": { "type": "number", "description": "Total number of followers.", "example": 9588130 }, "followers_detail": { "type": "null", "description": "", "example": null }, "following_count": { "type": "number", "description": "Total number of accounts the user follows.", "example": 37 }, "geofencing": { "type": "null", "description": "", "example": null }, "google_account": { "type": "string", "description": "", "example": "" }, "has_email": { "type": "boolean", "description": "Indicates whether the account has an email bound.", "example": false }, "has_facebook_token": { "type": "boolean", "description": "", "example": false }, "has_insights": { "type": "boolean", "description": "", "example": false }, "has_orders": { "type": "boolean", "description": "", "example": false }, "has_twitter_token": { "type": "boolean", "description": "", "example": false }, "has_youtube_token": { "type": "boolean", "description": "", "example": false }, "hide_search": { "type": "boolean", "description": "Indicates whether the profile is hidden from search results.", "example": true }, "homepage_bottom_toast": { "type": "null", "description": "", "example": null }, "ins_id": { "type": "string", "description": "Linked Instagram username.", "example": "disneyplus" }, "is_ad_fake": { "type": "boolean", "description": "", "example": false }, "is_discipline_member": { "type": "boolean", "description": "", "example": false }, "is_mute": { "type": "number", "description": "Mute status for this user (numeric flag).", "example": 0 }, "is_mute_lives": { "type": "number", "description": "Mute live status for this user (numeric flag).", "example": 0 }, "is_mute_non_story_post": { "type": "number", "description": "Mute non story post status for this user (numeric flag).", "example": 0 }, "is_mute_story": { "type": "number", "description": "Mute story status for this user (numeric flag).", "example": 0 }, "is_phone_binded": { "type": "boolean", "description": "Indicates whether a phone number is bound to the account.", "example": false }, "is_star": { "type": "boolean", "description": "Indicates whether the account is marked as a featured/celebrity account.", "example": false }, "item_list": { "type": "null", "description": "", "example": null }, "language": { "type": "string", "description": "Preferred language of the user (ISO code).", "example": "en" }, "live_agreement": { "type": "number", "description": "", "example": 0 }, "live_commerce": { "type": "boolean", "description": "Indicates whether live commerce features are enabled.", "example": false }, "live_verify": { "type": "number", "description": "", "example": 0 }, "mention_status": { "type": "number", "description": "Controls who can mention this user.", "example": 1 }, "mutual_relation_avatars": { "type": "null", "description": "", "example": null }, "need_points": { "type": "null", "description": "", "example": null }, "need_recommend": { "type": "number", "description": "", "example": 0 }, "nickname": { "type": "string", "description": "Display name of the user.", "example": "Disney+" }, "original_musician": { "type": "object", "properties": { "digg_count": { "type": "number", "description": "", "example": 0 }, "music_count": { "type": "number", "description": "", "example": 0 }, "music_used_count": { "type": "number", "description": "", "example": 0 }, "new_release_clip_ids": { "type": "null", "description": "", "example": null } } }, "platform_sync_info": { "type": "null", "description": "", "example": null }, "prevent_download": { "type": "boolean", "description": "Indicates whether video downloads are disabled.", "example": false }, "react_setting": { "type": "number", "description": "Controls who can react to the user’s videos.", "example": 0 }, "region": { "type": "string", "description": "Country or region code of the user (ISO 3166-1 alpha-2).", "example": "US" }, "relative_users": { "type": "null", "description": "", "example": null }, "reply_with_video_flag": { "type": "number", "description": "Controls reply-with-video permissions.", "example": 4 }, "room_id": { "type": "number", "description": "", "example": 0 }, "search_highlight": { "type": "null", "description": "", "example": null }, "sec_uid": { "type": "string", "description": "Secure unique identifier used for public API operations.", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "secret": { "type": "number", "description": "Indicates whether the account is private (numeric flag).", "example": 0 }, "share_info": { "type": "object", "description": "", "example": { } }, "share_qrcode_uri": { "type": "string", "description": "", "example": "" }, "shield_comment_notice": { "type": "number", "description": "", "example": 0 }, "shield_digg_notice": { "type": "number", "description": "", "example": 0 }, "shield_edit_field_info": { "type": "null", "description": "", "example": null }, "shield_follow_notice": { "type": "number", "description": "", "example": 0 }, "short_id": { "type": "string", "description": "Short numeric user identifier.", "example": "0" }, "show_image_bubble": { "type": "boolean", "description": "", "example": false }, "signature": { "type": "string", "description": "User profile biography text.", "example": "The greatest stories live here." }, "special_account": { "type": "object", "properties": { "special_account_list": { "type": "null", "description": "", "example": null } } }, "special_lock": { "type": "number", "description": "Indicates whether the profile has special lock restrictions.", "example": 1 }, "status": { "type": "number", "description": "Account status indicator.", "example": 1 }, "stitch_setting": { "type": "number", "description": "Controls who can stitch this user’s videos.", "example": 3 }, "total_favorited": { "type": "number", "description": "Total number of likes received across all videos.", "example": 48017440 }, "tw_expire_time": { "type": "number", "description": "", "example": 0 }, "twitter_id": { "type": "string", "description": "Linked Twitter account ID.", "example": "" }, "twitter_name": { "type": "string", "description": "Linked Twitter display name.", "example": "" }, "type_label": { "type": "null", "description": "", "example": null }, "uid": { "type": "string", "description": "Primary unique user identifier.", "example": "6844178288162063365" }, "unique_id": { "type": "string", "description": "Public username (handle) of the account.", "example": "disneyplus" }, "unique_id_modify_time": { "type": "number", "description": "Unix timestamp of the last username modification.", "example": 1772511805 }, "user_canceled": { "type": "boolean", "description": "Indicates whether the user has canceled or deactivated the account.", "example": false }, "user_mode": { "type": "number", "description": "User mode type indicator.", "example": 1 }, "user_period": { "type": "number", "description": "", "example": 0 }, "user_profile_guide": { "type": "null", "description": "", "example": null }, "user_rate": { "type": "number", "description": "User rating or classification indicator.", "example": 1 }, "user_spark_info": { "type": "object", "description": "", "example": { } }, "user_tags": { "type": "null", "description": "", "example": null }, "verification_type": { "type": "number", "description": "Numeric verification type identifier.", "example": 1 }, "verify_info": { "type": "string", "description": "Additional verification information displayed on profile.", "example": "" }, "video_icon": { "type": "object", "description": "", "example": { } }, "white_cover_url": { "type": "null", "description": "", "example": null }, "with_commerce_entry": { "type": "boolean", "description": "Indicates whether the commerce entry point is enabled.", "example": false }, "with_shop_entry": { "type": "boolean", "description": "Indicates whether the shop entry point is enabled.", "example": false }, "youtube_channel_id": { "type": "string", "description": "Linked YouTube channel ID.", "example": "" }, "youtube_channel_title": { "type": "string", "description": "Linked YouTube channel title.", "example": "" }, "youtube_expire_time": { "type": "number", "description": "", "example": 0 } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserFollowers", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "description": "User secUid. Either secUid or userId must be provided", "example": "MS4wLjABAAAATOyRAXMoa_yS82hI2holT9Dbi_zDpjay9cralDPtz0uQVp8KOMvcSDkbuljy797Y" } }, { "in": "query", "name": "userId", "schema": { "type": "string", "description": "User ID. Either secUid or userId must be provided", "example": "6530329342721922048" } }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 } }, { "in": "query", "name": "max_time", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "max_time parameter is used for pagination. In the first request, the default value of max_time is 0. For subsequent requests, the value of max_time will be taken from the response of the previous request", "example": 0 } } ], "summary": "Get User Follower", "description": "Get User Follower", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/followings": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "max_time": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 1772510719 }, "total": { "type": "number", "description": "Total number of users the account is following", "example": 24312 }, "followings": { "type": "array", "items": { "type": "object", "properties": { "accept_private_policy": { "type": "boolean", "description": "Indicates whether the user has accepted the platform privacy policy.", "example": false }, "account_labels": { "type": "null", "description": "Additional labels or badges associated with the account.", "example": null }, "account_region": { "type": "string", "description": "Region associated with the user account.", "example": "" }, "ad_cover_url": { "type": "null", "description": "Advertising-related cover image metadata.", "example": null }, "advance_feature_item_order": { "type": "null", "description": "Configuration for advanced feature item ordering on the profile.", "example": null }, "advanced_feature_info": { "type": "null", "description": "Additional advanced feature configuration information.", "example": null }, "apple_account": { "type": "number", "description": "Indicates whether the account is linked to Apple (numeric flag).", "example": 0 }, "authority_status": { "type": "number", "description": "Authority or moderation status of the account.", "example": 0 }, "avatar_168x168": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_300x300": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_larger": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_medium": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_thumb": { "type": "object", "properties": { "height": { "type": "number", "description": "The height of the avatar image in pixels.", "example": 720 }, "uri": { "type": "string", "description": "The internal URI or storage path of the avatar image on the CDN.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "A list of accessible URLs for the avatar image in different formats or resolutions.", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.webp?...", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7~tplv-tiktokx-cropcenter:168:168.jpeg?..." ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix used to construct full avatar image URLs. Can be null if not applicable.", "example": null }, "width": { "type": "number", "description": "The width of the avatar image in pixels.", "example": 720 } } }, "avatar_uri": { "type": "string", "description": "Internal CDN URI of the user avatar.", "example": "tos-maliva-avt-0068/0844f6dfc44957a40308a65f4afcada7" }, "aweme_count": { "type": "number", "description": "Total number of videos posted by the user.", "example": 1217 }, "bind_phone": { "type": "string", "description": "Masked phone number bound to the account.", "example": "" }, "bold_fields": { "type": "null", "description": "Fields highlighted in bold on the user profile.", "example": null }, "can_message_follow_status_list": { "type": "null", "description": "", "example": null }, "can_set_geofencing": { "type": "null", "description": "", "example": null }, "cha_list": { "type": "null", "description": "", "example": null }, "comment_filter_status": { "type": "number", "description": "Status of comment filtering settings.", "example": 0 }, "comment_setting": { "type": "number", "description": "Privacy setting controlling who can comment on videos.", "example": 0 }, "commerce_user_level": { "type": "number", "description": "Commerce account level indicator.", "example": 0 }, "cover_url": { "type": "array", "items": { "type": "string" }, "description": "List of profile cover image URLs.", "example": [] }, "create_time": { "type": "number", "description": "Unix timestamp when the account was created.", "example": 1593535515 }, "custom_verify": { "type": "string", "description": "Custom verification text displayed on the profile.", "example": "" }, "cv_level": { "type": "string", "description": "Creator verification level.", "example": "" }, "download_prompt_ts": { "type": "number", "description": "", "example": 0 }, "download_setting": { "type": "number", "description": "Controls who can download the user’s videos.", "example": 3 }, "duet_setting": { "type": "number", "description": "Controls who can create duet videos with this user.", "example": 3 }, "enabled_filter_all_comments": { "type": "boolean", "description": "", "example": false }, "enterprise_verify_reason": { "type": "string", "description": "Reason for enterprise account verification.", "example": "institution account" }, "events": { "type": "null", "description": "", "example": null }, "fake_data_info": { "type": "object", "description": "", "example": { } }, "favoriting_count": { "type": "number", "description": "Number of videos the user has favorited.", "example": 249 }, "fb_expire_time": { "type": "number", "description": "", "example": 0 }, "follower_count": { "type": "number", "description": "Total number of followers.", "example": 9588130 }, "followers_detail": { "type": "null", "description": "", "example": null }, "following_count": { "type": "number", "description": "Total number of accounts the user follows.", "example": 37 }, "geofencing": { "type": "null", "description": "", "example": null }, "google_account": { "type": "string", "description": "", "example": "" }, "has_email": { "type": "boolean", "description": "Indicates whether the account has an email bound.", "example": false }, "has_facebook_token": { "type": "boolean", "description": "", "example": false }, "has_insights": { "type": "boolean", "description": "", "example": false }, "has_orders": { "type": "boolean", "description": "", "example": false }, "has_twitter_token": { "type": "boolean", "description": "", "example": false }, "has_youtube_token": { "type": "boolean", "description": "", "example": false }, "hide_search": { "type": "boolean", "description": "Indicates whether the profile is hidden from search results.", "example": true }, "homepage_bottom_toast": { "type": "null", "description": "", "example": null }, "ins_id": { "type": "string", "description": "Linked Instagram username.", "example": "disneyplus" }, "is_ad_fake": { "type": "boolean", "description": "", "example": false }, "is_discipline_member": { "type": "boolean", "description": "", "example": false }, "is_mute": { "type": "number", "description": "Mute status for this user (numeric flag).", "example": 0 }, "is_mute_lives": { "type": "number", "description": "Mute live status for this user (numeric flag).", "example": 0 }, "is_mute_non_story_post": { "type": "number", "description": "Mute non story post status for this user (numeric flag).", "example": 0 }, "is_mute_story": { "type": "number", "description": "Mute story status for this user (numeric flag).", "example": 0 }, "is_phone_binded": { "type": "boolean", "description": "Indicates whether a phone number is bound to the account.", "example": false }, "is_star": { "type": "boolean", "description": "Indicates whether the account is marked as a featured/celebrity account.", "example": false }, "item_list": { "type": "null", "description": "", "example": null }, "language": { "type": "string", "description": "Preferred language of the user (ISO code).", "example": "en" }, "live_agreement": { "type": "number", "description": "", "example": 0 }, "live_commerce": { "type": "boolean", "description": "Indicates whether live commerce features are enabled.", "example": false }, "live_verify": { "type": "number", "description": "", "example": 0 }, "mention_status": { "type": "number", "description": "Controls who can mention this user.", "example": 1 }, "mutual_relation_avatars": { "type": "null", "description": "", "example": null }, "need_points": { "type": "null", "description": "", "example": null }, "need_recommend": { "type": "number", "description": "", "example": 0 }, "nickname": { "type": "string", "description": "Display name of the user.", "example": "Disney+" }, "original_musician": { "type": "object", "properties": { "digg_count": { "type": "number", "description": "", "example": 0 }, "music_count": { "type": "number", "description": "", "example": 0 }, "music_used_count": { "type": "number", "description": "", "example": 0 }, "new_release_clip_ids": { "type": "null", "description": "", "example": null } } }, "platform_sync_info": { "type": "null", "description": "", "example": null }, "prevent_download": { "type": "boolean", "description": "Indicates whether video downloads are disabled.", "example": false }, "react_setting": { "type": "number", "description": "Controls who can react to the user’s videos.", "example": 0 }, "region": { "type": "string", "description": "Country or region code of the user (ISO 3166-1 alpha-2).", "example": "US" }, "relative_users": { "type": "null", "description": "", "example": null }, "reply_with_video_flag": { "type": "number", "description": "Controls reply-with-video permissions.", "example": 4 }, "room_id": { "type": "number", "description": "", "example": 0 }, "search_highlight": { "type": "null", "description": "", "example": null }, "sec_uid": { "type": "string", "description": "Secure unique identifier used for public API operations.", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "secret": { "type": "number", "description": "Indicates whether the account is private (numeric flag).", "example": 0 }, "share_info": { "type": "object", "description": "", "example": { } }, "share_qrcode_uri": { "type": "string", "description": "", "example": "" }, "shield_comment_notice": { "type": "number", "description": "", "example": 0 }, "shield_digg_notice": { "type": "number", "description": "", "example": 0 }, "shield_edit_field_info": { "type": "null", "description": "", "example": null }, "shield_follow_notice": { "type": "number", "description": "", "example": 0 }, "short_id": { "type": "string", "description": "Short numeric user identifier.", "example": "0" }, "show_image_bubble": { "type": "boolean", "description": "", "example": false }, "signature": { "type": "string", "description": "User profile biography text.", "example": "The greatest stories live here." }, "special_account": { "type": "object", "properties": { "special_account_list": { "type": "null", "description": "", "example": null } } }, "special_lock": { "type": "number", "description": "Indicates whether the profile has special lock restrictions.", "example": 1 }, "status": { "type": "number", "description": "Account status indicator.", "example": 1 }, "stitch_setting": { "type": "number", "description": "Controls who can stitch this user’s videos.", "example": 3 }, "total_favorited": { "type": "number", "description": "Total number of likes received across all videos.", "example": 48017440 }, "tw_expire_time": { "type": "number", "description": "", "example": 0 }, "twitter_id": { "type": "string", "description": "Linked Twitter account ID.", "example": "" }, "twitter_name": { "type": "string", "description": "Linked Twitter display name.", "example": "" }, "type_label": { "type": "null", "description": "", "example": null }, "uid": { "type": "string", "description": "Primary unique user identifier.", "example": "6844178288162063365" }, "unique_id": { "type": "string", "description": "Public username (handle) of the account.", "example": "disneyplus" }, "unique_id_modify_time": { "type": "number", "description": "Unix timestamp of the last username modification.", "example": 1772511805 }, "user_canceled": { "type": "boolean", "description": "Indicates whether the user has canceled or deactivated the account.", "example": false }, "user_mode": { "type": "number", "description": "User mode type indicator.", "example": 1 }, "user_period": { "type": "number", "description": "", "example": 0 }, "user_profile_guide": { "type": "null", "description": "", "example": null }, "user_rate": { "type": "number", "description": "User rating or classification indicator.", "example": 1 }, "user_spark_info": { "type": "object", "description": "", "example": { } }, "user_tags": { "type": "null", "description": "", "example": null }, "verification_type": { "type": "number", "description": "Numeric verification type identifier.", "example": 1 }, "verify_info": { "type": "string", "description": "Additional verification information displayed on profile.", "example": "" }, "video_icon": { "type": "object", "description": "", "example": { } }, "white_cover_url": { "type": "null", "description": "", "example": null }, "with_commerce_entry": { "type": "boolean", "description": "Indicates whether the commerce entry point is enabled.", "example": false }, "with_shop_entry": { "type": "boolean", "description": "Indicates whether the shop entry point is enabled.", "example": false }, "youtube_channel_id": { "type": "string", "description": "Linked YouTube channel ID.", "example": "" }, "youtube_channel_title": { "type": "string", "description": "Linked YouTube channel title.", "example": "" }, "youtube_expire_time": { "type": "number", "description": "", "example": 0 } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserFollowings", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "description": "User secUid. Either secUid or userId must be provided", "example": "MS4wLjABAAAATOyRAXMoa_yS82hI2holT9Dbi_zDpjay9cralDPtz0uQVp8KOMvcSDkbuljy797Y" } }, { "in": "query", "name": "userId", "schema": { "type": "string", "description": "User ID. Either secUid or userId must be provided", "example": "6530329342721922048" } }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 } }, { "in": "query", "name": "max_time", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "max_time parameter is used for pagination. In the first request, the default value of max_time is 0. For subsequent requests, the value of max_time will be taken from the response of the previous request", "example": 0 } } ], "summary": "Get User Following", "description": "Get User Following", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/playlist": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "20" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "playList": { "type": "array", "items": { "type": "object", "properties": { "cover": { "type": "string", "description": "URL of the playlist cover image", "example": "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-85c255-tx/oIXDy1dyIIA7zvd0h4aiMdBUawivgUNvpnVBV~tplv-tiktokx-origin.image?dr=10395&x-expires=1763506800&x-signature=7oSZCLu5q6FKplEoHu5obvEcbjI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a" }, "creator": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true } }, "description": "Information of the user who created the playlist" }, "id": { "type": "string", "description": "Playlist ID", "example": "7556291800638425869" }, "mixId": { "type": "string", "description": "Alternate ID for the playlist", "example": "7556291800638425869" }, "mixName": { "type": "string", "description": "Display name of the playlist", "example": "Government shutdown" }, "name": { "type": "string", "description": "Display name of the playlist", "example": "Government shutdown" }, "videoCount": { "type": "number", "description": "Number of videos included in this playlist", "example": 5 } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserPlaylist", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "minLength": 1, "description": "User secUid", "example": "MS4wLjABAAAAOVL3gR6qKaY1C7FWW5x3dNZ-IXOYUrMA9PQ4k2kOZU9FNqvxo-xV4p_dUsQxtDUW" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "The number of results to be returned. The default and maximum value is 20", "example": 20 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Playlist", "description": "Get User Playlist", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/repost": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "30" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserRepost", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "minLength": 1, "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 35, "description": "The number of results to be returned. The default and maximum value is 35", "example": 35 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Repost", "description": "Get User Repost", "security": [ { "apiKeyAuth": [] } ] } }, "/api/user/story": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "CurrentPosition": { "type": "string", "description": "The current story position index as a string", "example": "0" }, "HasMoreAfter": { "type": "boolean", "description": "Whether there are more stories after the current position", "example": false }, "HasMoreBefore": { "type": "boolean", "description": "Whether there are more stories before the current position", "example": false }, "LastStoryCreatedAt": { "type": "string", "description": "Timestamp of the last created story", "example": "1764090811561" }, "MaxCursor": { "type": "string", "description": "maxCursor cursor value for pagination", "example": "1764090811561" }, "MinCursor": { "type": "string", "description": "", "example": "1764090811561" }, "TotalCount": { "type": "string", "description": "Total number of stories", "example": "1" }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } }, "story": { "type": "object", "properties": { "ExpiredAt": { "type": "number", "description": "Timestamp when the story will expire", "example": 1764177211000 }, "IsOfficial": { "type": "boolean", "description": "Indicates if the story is an official story", "example": false } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiUserStory", "tags": [ "User" ], "parameters": [ { "in": "query", "name": "userId", "schema": { "type": "string", "description": "User ID", "example": "6803724582765200389" }, "required": true }, { "in": "query", "name": "maxCursor", "schema": { "type": "string", "description": "maxCursor parameter is used for pagination. In the first request, the default value of maxCursor is 0. For subsequent requests, the value of maxCursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get User Story", "description": "Get User Story", "security": [ { "apiKeyAuth": [] } ] } }, "/api/post/detail": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "itemInfo": { "type": "object", "properties": { "itemStruct": { "type": "object", "properties": { "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "desc": { "type": "string", "description": "Description of the video provided by the creator", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "createTime": { "type": "string", "description": "Create time of the post (timestamp)", "example": "1763039850" }, "scheduleTime": { "type": "number", "description": "Scheduled publish time of the video (0 if not scheduled)", "example": 0 }, "video": { "type": "object", "properties": { "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "height": { "type": "number", "description": "Height of the video in pixels", "example": 1024 }, "width": { "type": "number", "description": "Width of the video in pixels", "example": 576 }, "duration": { "type": "number", "description": "Duration of the video in seconds", "example": 39 }, "ratio": { "type": "string", "description": "Resolution label of the video", "example": "540p" }, "cover": { "type": "string", "description": "URL of the video’s main cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osCk3NEAKKAiiipODvIExcfFA2BWiBAIGAx0Wl~tplv-tiktokx-origin.image?dr=14575&x-expires=1763737200&x-signature=lXBPxdNjO1vMYGotOAHXsOujlWI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2" }, "originCover": { "type": "string", "description": "URL of the original uploaded cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ok3nOP65ENkAilbjcIRBaBxEVKHIAN8BiOcVU~tplv-tiktokx-origin.image?dr=14575&x-expires=1763737200&x-signature=zQaS%2FhzZ%2BUdVjWheCoqG5YAnA8Q%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2" }, "dynamicCover": { "type": "string", "description": "URL of the animated or dynamic cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osCk3NEAKKAiiipODvIExcfFA2BWiBAIGAx0Wl~tplv-tiktokx-origin.image?dr=14575&x-expires=1763737200&x-signature=lXBPxdNjO1vMYGotOAHXsOujlWI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=-Csk_mfMPD12NP9~ld-UxxG2aY6e3wv25UcAp&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764251717&l=20251125215246678910C1EE619C94769F&ply_type=2&policy=2&signature=920ee915eb10acb520ab257c22253be5&tk=tt_chain_token" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=-Csk_mfMPD12NP9~ld-UxxG2aY6e3wv25UcAp&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764251717&l=20251125215246678910C1EE619C94769F&ply_type=2&policy=2&signature=1eaf82ba64d3b130e2d11574cdd72656&tk=tt_chain_token" }, "reflowCover": { "type": "string", "description": "URL of the reflow-optimized cover image", "example": "" }, "bitrate": { "type": "number", "description": "Bitrate of the video in bits per second", "example": 1434798 }, "encodedType": { "type": "string", "description": "Encoding type of the video", "example": "normal" }, "format": { "type": "string", "description": "File format of the video", "example": "mp4" }, "videoQuality": { "type": "string", "description": "Quality label of the video", "example": "normal" }, "encodeUserTag": { "type": "string", "description": "Tiktok internal encoding tag applied to the video", "example": "" }, "codecType": { "type": "string", "description": "Codec type used for encoding the video", "example": "540p" }, "size": { "type": "string", "description": "File size of the video in bytes", "example": "7055440" } } }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "createTime": { "type": "number", "description": "Unix timestamp when the user account was created", "example": 1628514847 }, "uniqueIdModifyTime": { "type": "number", "description": "Unix timestamp of the last modification of the unique ID", "example": 0 }, "nickNameModifyTime": { "type": "number", "description": "Unix timestamp of the last time the user’s nickname was modified", "example": 0 }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "originalItem": { "type": "boolean", "description": "Indicates whether the video is the original upload", "example": false }, "officalItem": { "type": "boolean", "description": "Indicates whether the post is marked as official content", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is secret", "example": false }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is visible only to friends", "example": false }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "itemCommentStatus": { "type": "number", "description": "Comment permission status for the video", "example": 0 }, "takeDown": { "type": "number", "description": "Indicates whether the video has been taken down", "example": 0 }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is marked as private", "example": false }, "duetEnabled": { "type": "boolean", "description": "Indicates whether Duet is enabled for this video", "example": true }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether Stitch is enabled for this video", "example": true }, "isAd": { "type": "boolean", "description": "Indicates whether this post contains advertisement content", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is allowed for this video", "example": true }, "duetDisplay": { "type": "number", "description": "Display status of Duet permissions for the video", "example": 0 }, "stitchDisplay": { "type": "number", "description": "Display status of Stitch permissions for the video", "example": 0 }, "indexEnabled": { "type": "boolean", "description": "Indicates whether the video is allowed to be indexed", "example": true }, "adLabelVersion": { "type": "number", "description": "Version number of the ad label applied to the post", "example": 2 }, "locationCreated": { "type": "string", "description": "Location where the video was created", "example": "US" }, "BAInfo": { "type": "string", "description": "Business account–related metadata or tags", "example": "" }, "suggestedWords": { "type": "array", "items": { "type": "string" }, "description": "Related or suggested keywords extracted from the post", "example": [ "taylor swift", "the eras tour", "eras tour" ] }, "CategoryType": { "type": "number", "description": "Category identifier assigned to the post", "example": 120 }, "textLanguage": { "type": "string", "description": "Detected language of the video caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the video text can be translated", "example": true } } } } }, "statusCode": { "type": "number", "description": "Status Code\n - 0: Success\n - 10204: Item doesn't exist\n ", "example": 0 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPostDetail", "tags": [ "Post" ], "parameters": [ { "in": "query", "name": "videoId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Video ID", "example": "7572198435487501598" }, "required": true } ], "summary": "Get Post Detail", "description": "Get Post Detail", "security": [ { "apiKeyAuth": [] } ] } }, "/api/post/comments": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 50 }, "total": { "type": "number", "description": "Total number of comments the post currently has", "example": 248 }, "comments": { "type": "array", "items": { "type": "object", "properties": { "allow_download_photo": { "type": "boolean", "description": "Indicates whether users are allowed to download photos from this comment", "example": true }, "author_pin": { "type": "boolean", "description": "Indicates whether the author of the post has pinned this comment", "example": false }, "aweme_id": { "type": "string", "description": "Post ID", "example": "7306132438047116586" }, "cid": { "type": "string", "description": "Comment ID", "example": "7500675626996744968" }, "collect_stat": { "type": "number", "description": "Number of times this comment has been collected", "example": 0 }, "comment_language": { "type": "string", "description": "Language code of the comment (ISO 639-1)", "example": "en" }, "create_time": { "type": "number", "description": "Timestamp when the comment was created (Unix epoch time)", "example": 1746387170 }, "digg_count": { "type": "number", "description": "Number of likes the comment has received", "example": 6 }, "is_author_digged": { "type": "boolean", "description": "Indicates whether the author of the post has liked this comment", "example": false }, "is_comment_translatable": { "type": "boolean", "description": "Whether the comment can be translated using TikTok translation feature", "example": true }, "is_high_purchase_intent": { "type": "boolean", "description": "Indicates whether the comment shows high purchase intent", "example": false }, "reply_comment_total": { "type": "number", "description": "Total number of replies to this comment", "example": 6 }, "reply_id": { "type": "string", "description": "ID of this reply comment", "example": "0" }, "reply_to_reply_id": { "type": "string", "description": "If this comment is a reply to another reply, this field contains that reply ID", "example": "0" }, "sort_extra_score": { "type": "object", "properties": { "reply_score": { "type": "number", "description": "Score used for ranking replies", "example": 0.006336 }, "show_more_score": { "type": "number", "description": "Score used for “show more” sorting logic", "example": 0.085608 } } }, "status": { "type": "number", "description": "Status of the comment", "example": 1 }, "stick_position": { "type": "number", "description": "If pinned, indicates the pinned position", "example": 0 }, "text": { "type": "string", "description": "Content of the comment", "example": "Hello guys" }, "user": { "type": "object", "properties": { "account_labels": { "type": [ "string", "null" ], "description": "Labels or tags associated with the user account", "example": null }, "ad_cover_url": { "type": [ "string", "null" ], "description": "URL of the advertisement cover image", "example": null }, "advance_feature_item_order": { "type": [ "string", "null" ], "description": "Order information for advanced feature items", "example": null }, "advanced_feature_info": { "type": [ "string", "null" ], "description": "Additional info about advanced features for the user account", "example": null }, "avatar_thumb": { "type": "object", "properties": { "uri": { "type": "string", "description": "Relative URI of the user avatar thumbnail", "example": "tos-alisg-avt-0068/5fee0198a94bfb49960780fa8ff42e72" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "Full URLs for the user avatar thumbnail in multiple formats", "example": [ "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5fee0198a94bfb49960780fa8ff42e72~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=de42bc37&x-expires=1763629200&x-signature=6OEuZ0tmvBa7DZaz8Dt6dPfmaxk%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my", "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5fee0198a94bfb49960780fa8ff42e72~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=66560ee7&x-expires=1763629200&x-signature=Y9IXcfNdP3yi6259tCG1Id5bFOM%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix for avatar resources", "example": null } } }, "bold_fields": { "type": [ "string", "null" ], "description": "Fields that should be displayed in bold on the user profile", "example": null }, "can_message_follow_status_list": { "type": [ "string", "null" ], "description": "Indicates messaging permissions based on follow status", "example": null }, "can_set_geofencing": { "type": [ "string", "null" ], "description": "Indicates whether the user can set geofencing for content", "example": null }, "cha_list": { "type": [ "string", "null" ], "description": "List of challenges the user is associated with", "example": null }, "cover_url": { "type": [ "string", "null" ], "description": "Cover image URL for the user profile", "example": null }, "custom_verify": { "type": "string", "description": "Custom verification badge or label for the user", "example": "" }, "enterprise_verify_reason": { "type": "string", "description": "Reason for enterprise verification", "example": "" }, "events": { "type": [ "string", "null" ], "description": "Events associated with the user", "example": null }, "followers_detail": { "type": [ "string", "null" ], "description": "Details about the user’s followers", "example": null }, "geofencing": { "type": [ "string", "null" ], "description": "Geofencing information for user content", "example": null }, "homepage_bottom_toast": { "type": [ "string", "null" ], "description": "Toast message displayed at the bottom of the user homepage", "example": null }, "item_list": { "type": [ "string", "null" ], "description": "List of items associated with the user account", "example": null }, "mutual_relation_avatars": { "type": [ "string", "null" ], "description": "Avatars of mutual followers or relations", "example": null }, "need_points": { "type": [ "string", "null" ], "description": "Indicates if user requires points for certain actions", "example": null }, "nickname": { "type": "string", "description": "Nickname of the user", "example": "Taylor Swift" }, "platform_sync_info": { "type": [ "string", "null" ], "description": "Information about platform synchronization", "example": null }, "relative_users": { "type": [ "string", "null" ], "description": "Related users", "example": null }, "search_highlight": { "type": [ "string", "null" ], "description": "Highlighted text when this user appears in search results", "example": null }, "sec_uid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "shield_edit_field_info": { "type": [ "string", "null" ], "description": "Information about fields shielded from editing", "example": null }, "type_label": { "type": [ "string", "null" ], "description": "Label describing the type of user account", "example": null }, "uid": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "unique_id": { "type": "string", "description": "User Unique ID", "example": "taylorswift" }, "user_profile_guide": { "type": [ "string", "null" ], "description": "Guide for user profile actions", "example": null }, "user_tags": { "type": [ "string", "null" ], "description": "Tags associated with the user account", "example": null }, "white_cover_url": { "type": [ "string", "null" ], "description": "Alternative cover image URL for user profile", "example": null } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPostComments", "tags": [ "Post" ], "parameters": [ { "in": "query", "name": "videoId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Video ID", "example": "7306132438047116586" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 50, "description": "The number of results to be returned. The default and maximum value is 50", "example": 50 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "example": 0 }, "required": false } ], "summary": "Get Post Comments", "description": "Get Post Comments", "security": [ { "apiKeyAuth": [] } ] } }, "/api/post/comment/replies": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 6 }, "total": { "type": "number", "description": "Total number of replies comment the comment currently has", "example": 210 }, "comments": { "type": "array", "items": { "type": "object", "properties": { "aweme_id": { "type": "string", "description": "Post ID", "example": "7306132438047116586" }, "cid": { "type": "string", "description": "Comment ID", "example": "7500675626996744968" }, "collect_stat": { "type": "number", "description": "Number of times this comment has been collected", "example": 0 }, "comment_language": { "type": "string", "description": "Language code of the comment (ISO 639-1)", "example": "en" }, "create_time": { "type": "number", "description": "Timestamp of when the comment was created (Unix epoch time)", "example": 1701092134 }, "digg_count": { "type": "number", "description": "Number of likes the comment has received", "example": 1191 }, "is_author_digged": { "type": "boolean", "description": "Indicates whether the author of the post has liked this comment", "example": false }, "is_comment_translatable": { "type": "boolean", "description": "Whether the comment can be translated using TikTok translation feature", "example": true }, "is_high_purchase_intent": { "type": "boolean", "description": "Indicates whether the comment shows high purchase intent", "example": false }, "reply_id": { "type": "string", "description": "ID of this reply comment", "example": "7306133620770751250" }, "reply_to_reply_id": { "type": "string", "description": "If this comment is a reply to another reply, this field contains that reply ID", "example": "0" }, "status": { "type": "number", "description": "Status of the comment", "example": 1 }, "stick_position": { "type": "number", "description": "If pinned, indicates the pinned position", "example": 0 }, "text": { "type": "string", "description": "Content of the commentt", "example": "and nbnc 😞" }, "user": { "type": "object", "properties": { "account_labels": { "type": [ "string", "null" ], "description": "Labels or tags associated with the user account", "example": null }, "ad_cover_url": { "type": [ "string", "null" ], "description": "URL of the advertisement cover image", "example": null }, "advance_feature_item_order": { "type": [ "string", "null" ], "description": "Order information for advanced feature items", "example": null }, "advanced_feature_info": { "type": [ "string", "null" ], "description": "Additional info about advanced features for the user account", "example": null }, "avatar_thumb": { "type": "object", "properties": { "uri": { "type": "string", "description": "Relative URI of the user avatar thumbnail", "example": "tos-alisg-avt-0068/5fee0198a94bfb49960780fa8ff42e72" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "Full URLs for the user avatar thumbnail in multiple formats", "example": [ "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5fee0198a94bfb49960780fa8ff42e72~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=de42bc37&x-expires=1763629200&x-signature=6OEuZ0tmvBa7DZaz8Dt6dPfmaxk%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my", "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5fee0198a94bfb49960780fa8ff42e72~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=66560ee7&x-expires=1763629200&x-signature=Y9IXcfNdP3yi6259tCG1Id5bFOM%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix for avatar resources", "example": null } } }, "bold_fields": { "type": [ "string", "null" ], "description": "Fields that should be displayed in bold on the user profile", "example": null }, "can_message_follow_status_list": { "type": [ "string", "null" ], "description": "Indicates messaging permissions based on follow status", "example": null }, "can_set_geofencing": { "type": [ "string", "null" ], "description": "Indicates whether the user can set geofencing for content", "example": null }, "cha_list": { "type": [ "string", "null" ], "description": "List of challenges the user is associated with", "example": null }, "cover_url": { "type": [ "string", "null" ], "description": "Cover image URL for the user profile", "example": null }, "custom_verify": { "type": "string", "description": "Custom verification badge or label for the user", "example": "" }, "enterprise_verify_reason": { "type": "string", "description": "Reason for enterprise verification", "example": "" }, "events": { "type": [ "string", "null" ], "description": "Events associated with the user", "example": null }, "followers_detail": { "type": [ "string", "null" ], "description": "Details about the user’s followers", "example": null }, "geofencing": { "type": [ "string", "null" ], "description": "Geofencing information for user content", "example": null }, "homepage_bottom_toast": { "type": [ "string", "null" ], "description": "Toast message displayed at the bottom of the user homepage", "example": null }, "item_list": { "type": [ "string", "null" ], "description": "List of items associated with the user account", "example": null }, "mutual_relation_avatars": { "type": [ "string", "null" ], "description": "Avatars of mutual followers or relations", "example": null }, "need_points": { "type": [ "string", "null" ], "description": "Indicates if user requires points for certain actions", "example": null }, "nickname": { "type": "string", "description": "Nickname of the user", "example": "Taylor Swift" }, "platform_sync_info": { "type": [ "string", "null" ], "description": "Information about platform synchronization", "example": null }, "relative_users": { "type": [ "string", "null" ], "description": "Related users", "example": null }, "search_highlight": { "type": [ "string", "null" ], "description": "Highlighted text when this user appears in search results", "example": null }, "sec_uid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "shield_edit_field_info": { "type": [ "string", "null" ], "description": "Information about fields shielded from editing", "example": null }, "type_label": { "type": [ "string", "null" ], "description": "Label describing the type of user account", "example": null }, "uid": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "unique_id": { "type": "string", "description": "User Unique ID", "example": "taylorswift" }, "user_profile_guide": { "type": [ "string", "null" ], "description": "Guide for user profile actions", "example": null }, "user_tags": { "type": [ "string", "null" ], "description": "Tags associated with the user account", "example": null }, "white_cover_url": { "type": [ "string", "null" ], "description": "Alternative cover image URL for user profile", "example": null } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPostCommentReplies", "tags": [ "Post" ], "parameters": [ { "in": "query", "name": "videoId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Video ID", "example": "7306132438047116586" }, "required": true }, { "in": "query", "name": "commentId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Comment ID", "example": "7306133620770751250" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 6, "description": "The number of results to be returned. The default and maximum value is 6", "example": 6 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "example": 0 }, "required": false } ], "summary": "Get Post Reply Comments", "description": "Get Post Reply Comments", "security": [ { "apiKeyAuth": [] } ] } }, "/api/post/related": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "-1" }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPostRelated", "tags": [ "Post" ], "parameters": [ { "in": "query", "name": "videoId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Video ID", "example": "7572198435487501598" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get Related Posts", "description": "Get Related Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/post/explore": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPostExplore", "tags": [ "Post" ], "parameters": [ { "in": "query", "name": "categoryType", "schema": { "anyOf": [ { "type": "string" }, { "type": "number" } ], "description": "Category Type. Allowed values:\n- 100: Anime & Comics\n- 101: Shows\n- 102: Beauty Care\n- 103: Games\n- 104: Comedy\n- 105: Daily Life\n- 106: Family\n- 107: Relationship\n- 108: Drama\n- 109: Outfit\n- 110: Lipsync\n- 111: Food\n- 112: Sports\n- 113: Animals\n- 114: Society\n- 115: Cars\n- 116: Education\n- 117: Fitness & Health\n- 118: Technology\n- 119: Singing & Dancing", "example": 101 }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 16, "description": "The number of results to be returned. The default and maximum value is 16", "example": 16 }, "required": false } ], "summary": "Get Posts by Category", "description": "Get Posts by Category", "security": [ { "apiKeyAuth": [] } ] } }, "/api/post/discover": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "seoBizItemInfoList": { "type": "array", "items": { "type": "object", "properties": { "itemId": { "type": "string", "description": "", "example": "7588556037062479135" }, "customTdk": { "type": "object", "properties": { "article": { "type": "string", "description": "", "example": "" }, "description": { "type": "string", "description": "", "example": "Join the celebration for the New Year 2026 and embrace the excitement of motorcycle adventures. 🎉🏍️ Let's welcome the new year together! #2026 #newyear #motorcycle" }, "keywords": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "2026 new year", "motorcycle celebration", "new year motorcycle adventures" ] }, "title": { "type": "string", "description": "", "example": "Hello 2026: New Year Motorcycle Celebration" } } } } } }, "videoList": { "type": "array", "items": { "type": "object", "properties": { "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } }, "diversificationLabels": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "Random Shoot", "Others" ] } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPostDiscover", "tags": [ "Post" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "description": "Keyword", "example": "new-year" }, "required": true }, { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 }, "required": false } ], "summary": "Discover Posts by Keyword", "description": "Discover Posts by Keyword", "security": [ { "apiKeyAuth": [] } ] } }, "/api/live/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "example": { "AnchorABMap": { }, "adjust_display_order": 0, "admin_ec_show_permission": { }, "admin_user_ids": [], "age_restricted": { "AgeInterval": 0, "restricted": false, "source": 0 }, "aigc_self_disclosure_switch": false, "all_emoji_list": [], "allow_preview_time": -1, "anchor_scheduled_time_text": "", "anchor_share_text": "", "anchor_tab_type": 7, "answering_question_content": "", "app_id": 8311, "audio_mute": 0, "auto_cover": 0, "biz_sticker_list": [], "book_end_time": 0, "book_time": 0, "business_live": 0, "challenge_info": "", "client_version": 11909, "comment_has_text_emoji_emote": 0, "comment_name_mode": 0, "commerce_info": { "commerce_permission": 0, "oec_live_enter_room_init_data": "", "product_num": 0, "use_async_load": false, "use_new_promotion": 0 }, "common_label_list": "", "content_tag": "", "continuous_room_quota_config": { }, "cover": { "avg_color": "#BCD9E0", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "webcast-va/7197507146179955462", "url_list": [ "https://p16-webcast.tiktokcdn.com/webcast-va/7197507146179955462~tplv-obj.image", "https://p19-webcast.tiktokcdn.com/webcast-va/7197507146179955462~tplv-obj.image" ], "width": 0 }, "cover_type": 2, "cpp_version": 0, "create_time": 1773790105, "deco_list": [], "deprecated10": "", "deprecated11": "", "deprecated12": "", "deprecated13": "", "deprecated14": 0, "deprecated15": 0, "deprecated16": 0, "deprecated17": [], "deprecated18": 0, "deprecated19": "", "deprecated195": false, "deprecated2": "", "deprecated20": 0, "deprecated21": false, "deprecated22": 0, "deprecated23": "", "deprecated24": 0, "deprecated26": "", "deprecated28": "", "deprecated3": { }, "deprecated30": "", "deprecated31": false, "deprecated32": "", "deprecated35": 0, "deprecated36": 0, "deprecated39": "", "deprecated4": 0, "deprecated41": 0, "deprecated43": false, "deprecated44": 0, "deprecated5": false, "deprecated6": "", "deprecated7": 0, "deprecated8": "", "deprecated9": "", "detect_anchor_leave": 0, "disable_preload_stream": false, "disable_preview_sub_only": 0, "disable_screen_record": false, "drawer_tab_position": "", "drop_comment_group": 0, "ec_age_interval": 0, "ecom_room_type": 0, "ecommerce_room_tags": [], "effect_frame_upload_demotion": 0, "effect_info": [], "emoji_list": [], "enable_optimize_sensitive_word": false, "enable_server_drop": 0, "enable_stream_encryption": false, "enlarge_view_info": { "ab_result": false, "enabler_enlarge_view": false, "in_enlarge_blacklist": false, "landscape_view": 0, "portrait_view": 0 }, "existed_commerce_goods": false, "existed_ttls_goods": false, "fansclub_msg_style": 2, "feed_room_label": { "avg_color": "#BCBCE0", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "webcast-sg/2ea90002aca1159b5c67", "url_list": [ "https://p16-webcast.tiktokcdn.com/img/alisg/webcast-sg/2ea90002aca1159b5c67~tplv-obj.image", "https://p19-webcast.tiktokcdn.com/img/alisg/webcast-sg/2ea90002aca1159b5c67~tplv-obj.image" ], "width": 0 }, "feed_room_labels": [], "filter_msg_rules": [], "finish_reason": 0, "finish_time": 1773806468, "finish_url": "", "finish_url_v2": "", "follow_msg_style": 2, "forbidden_copy": false, "forum_extra_data": "", "fyp_skylight_avatar_refresh": 0, "game_demo": 0, "game_tag": [ { "bundle_id": "", "full_name": "", "game_category": [], "gar": [], "hashtag_id": [5], "hashtag_list": [], "id": 102, "is_new_game": false, "landscape": 0, "package_name": "", "short_name": "", "show_name": "Garena Free Fire" } ], "gift_msg_style": 2, "gift_poll_vote_enabled": false, "group_source": 0, "gs_guessing_xtab_ab_param": 0, "has_commerce_goods": false, "has_more_history_comment": false, "has_ttls_goods": false, "has_ttls_live_permission": false, "has_used_music": false, "has_viewer_wishes_game_tricks": false, "hashtag": { "id": 5, "image": { "avg_color": "#DCF4FA", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "webcast-sg/5Gaming.png", "url_list": [ "https://p16-webcast.tiktokcdn.com/img/alisg/webcast-sg/5Gaming.png~tplv-obj.image", "https://p19-webcast.tiktokcdn.com/img/alisg/webcast-sg/5Gaming.png~tplv-obj.image" ], "width": 0 }, "namespace": 0, "title": "Gaming" }, "have_wishlist": false, "history_comment_cursor": "", "history_comment_list": [], "host_board_status": 0, "hot_sentence_info": "", "id": 7.618370406579244e+18, "id_str": "7618370406579243792", "idc_region": "", "indicators": [], "intended_drm": "", "interaction_question_version": 1, "interception": false, "introduction": "", "is_game": 0, "is_gated_room": false, "is_replay": false, "is_reposted_expect": 0, "is_show_user_card_switch": false, "is_stream_low_latency": false, "is_tag2_sfv_relation_pair": false, "last_ping_time": 1773806468, "layout": 0, "like_agg_optimize_group": 0, "like_count": 0, "link_mic": { "ab_infos": { }, "audience_id_list": [], "battle_scores": [], "battle_settings": { "battle_id": 0, "battle_status": 0, "channel_id": 0, "duration": 0, "finished": 0, "match_type": 0, "start_time": 0, "start_time_ms": 0, "theme": "" }, "channel_id": 0, "channel_info": { "dimension": 0, "group_channel_id": 0, "inner_channel_id": 0, "layout": 0, "vendor": 0 }, "followed_count": 0, "link_mic_channel": 0, "linked_user_list": [], "linker_mode": 0, "linkmic_unify_channel_id": 0, "multi_guest_enable": false, "multi_live_enum": 1, "rival_anchor_id": 0, "show_user_list": [] }, "linker_map": { }, "linkmic_layout": 0, "lite_user_not_visible": false, "lite_user_visible": false, "live_distribution": [], "live_id": 12, "live_reason": "", "live_room_mode": 6, "live_sub_only": 0, "live_sub_only_month": 0, "live_sub_only_tier": 0, "live_sub_only_use_music": 0, "live_type_audio": false, "live_type_linkmic": false, "live_type_normal": false, "live_type_sandbox": false, "live_type_screenshot": false, "live_type_social_live": false, "live_type_third_party": true, "living_room_attrs": { "admin_flag": 0, "rank": 0, "room_id": 7.618370406579244e+18, "room_id_str": "7618370406579243792", "silence_flag": 0 }, "log_id": "2026031812011014795160E4D0EB490726", "lottery_finish_time": 0, "max_continue_watch_mill_seconds": 0, "max_preview_time": 60000, "mosaic_status": 0, "multi_stream_id": 0, "multi_stream_id_str": "", "multi_stream_net_mode": 0, "multi_stream_scene": 0, "multi_stream_source": 0, "multi_stream_url": { "alive_timestamp": 0, "candidate_resolution": [], "complete_push_urls": [], "default_resolution": "", "drm_type": 0, "extra": { "anchor_interact_profile": 0, "audience_interact_profile": 0, "bframe_enable": false, "bitrate_adapt_strategy": 0, "bytevc1_enable": false, "default_bitrate": 0, "deprecated1": false, "fps": 0, "gop_sec": 0, "hardware_encode": false, "height": 0, "max_bitrate": 0, "min_bitrate": 0, "roi": false, "super_resolution": { "antialiasing": false, "enable": false, "strength": 0 }, "sw_roi": false, "video_profile": 0, "width": 0 }, "flv_pull_url": { }, "flv_pull_url_params": { }, "hls_pull_url": "", "hls_pull_url_map": { }, "hls_pull_url_params": "", "id": 0, "id_str": "", "live_core_sdk_data": { "pull_data": { "options": { "default_preview_quality": { "icon_type": 0, "level": 0, "name": "", "resolution": "", "sdk_key": "", "v_codec": "" }, "default_quality": { "icon_type": 0, "level": 0, "name": "", "resolution": "", "sdk_key": "", "v_codec": "" }, "qualities": [], "show_quality_button": false, "support_low_latency": false }, "stream_data": "" }, "push_data": { "push_stream_level": 0, "resolution_params": { }, "stream_data": "" } }, "provider": 0, "push_resolution": "", "push_urls": [], "resolution_name": { }, "rtmp_pull_url": "", "rtmp_pull_url_params": "", "rtmp_push_url": "", "rtmp_push_url_params": "", "stream_app_id": 0, "stream_control_type": 0, "stream_delay_ms": 0, "stream_size_height": 0, "stream_size_width": 0, "vr_type": 0 }, "net_mode": 0, "os_type": 0, "owner": { "allow_find_by_contacts": false, "allow_others_download_video": false, "allow_others_download_when_sharing_video": false, "allow_share_show_profile": false, "allow_show_in_gossip": false, "allow_show_my_action": false, "allow_strange_comment": false, "allow_unfollower_comment": false, "allow_use_linkmic": false, "avatar_large": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "1080x1080/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d", "url_list": [ "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=565c5068&x-expires=1773979200&x-signature=4rPFw5Emdir3ILhgtkG8sQ8OfiA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2", "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=d2d51c80&x-expires=1773979200&x-signature=%2FQbjka3q7p135ux6jv9I2257Cpc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2" ], "width": 0 }, "avatar_medium": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "720x720/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d", "url_list": [ "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=5c0fc299&x-expires=1773979200&x-signature=%2BzI%2Ft4cpsgJwhJ%2F2dE%2Fm5a%2BoG%2Fo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2", "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=8e896b7c&x-expires=1773979200&x-signature=6qmH8YO8yXOOSEqS8%2FF%2B22YVIuM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2" ], "width": 0 }, "avatar_thumb": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "100x100/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d", "url_list": [ "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=9a0995be&x-expires=1773975600&x-signature=Mv7i71RF8SnpQ2jy8NMZxrbm0zQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=3ea1580e&idc=my2", "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/c9a5785324b649b280c79e66f943284d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=673157ab&x-expires=1773975600&x-signature=7UMrQX%2FJahwgvAllnRowQqbubwg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=3ea1580e&idc=my2" ], "width": 0 }, "badge_image_list": [], "badge_list": [], "bg_img_url": "", "bio_description": "Galería: CRIS 🦁🌹🤠🩷BLOODFIRE✈️ITPMendoza🐋CASTRO🌌F7Ramos🦢CHAPIN😘", "block_status": 0, "border_list": [], "comment_restrict": 0, "commerce_webcast_config_ids": [], "constellation": "", "create_time": 0, "deprecated1": 0, "deprecated12": 0, "deprecated13": 0, "deprecated15": 0, "deprecated16": false, "deprecated17": false, "deprecated18": "", "deprecated19": false, "deprecated2": 0, "deprecated21": 0, "deprecated28": false, "deprecated29": "", "deprecated3": 0, "deprecated4": 0, "deprecated5": "", "deprecated6": 0, "deprecated7": "", "deprecated8": 0, "disable_ichat": 0, "display_id": "eltomboff", "enable_ichat_img": 0, "exp": 0, "fan_ticket_count": 0, "fans_club_info": { "badge": { "avg_color": "", "height": 0, "image_type": 35, "is_animated": false, "open_web_url": "", "uri": "webcast-va/fans_left_up_corner_entrance_icon_lv1_v0.png", "url_list": [ "https://p16-webcast.tiktokcdn.com/webcast-va/fans_left_up_corner_entrance_icon_lv1_v0.png~tplv-obj.image", "https://p19-webcast.tiktokcdn.com/webcast-va/fans_left_up_corner_entrance_icon_lv1_v0.png~tplv-obj.image" ], "width": 0 }, "fans_club_name": "", "fans_count": 0, "fans_level": 0, "fans_score": 0, "is_sleeping": false }, "fold_stranger_chat": false, "follow_info": { "follow_status": 0, "follower_count": 520275, "following_count": 58, "push_status": 0 }, "follow_status": 0, "ichat_restrict_type": 0, "id": 6.788752804346496e+18, "id_str": "6788752804346496006", "is_anchor_marked": false, "is_block": false, "is_follower": false, "is_following": false, "is_subscribe": false, "link_mic_stats": 2, "media_badge_image_list": [], "mint_type_label": [7.160893592603462e+18], "modify_time": 1773804171, "need_profile_guide": false, "new_real_time_icons": [], "nickname": "EL TOMBO FF 👮🏼‍♂️", "own_room": { "room_ids": [7.618370406579244e+18], "room_ids_str": [ "7618370406579243792" ] }, "pay_grade": { "deprecated20": 0, "deprecated22": 0, "deprecated23": 0, "deprecated24": 0, "deprecated25": 0, "deprecated26": 0, "grade_banner": "", "grade_describe": "", "grade_icon_list": [], "level": 0, "name": "", "next_name": "", "next_privileges": "", "score": 0, "screen_chat_type": 0, "upgrade_need_consume": 0 }, "pay_score": 0, "pay_scores": 0, "push_comment_status": false, "push_digg": false, "push_follow": false, "push_friend_action": false, "push_ichat": false, "push_status": false, "push_video_post": false, "push_video_recommend": false, "real_time_icons": [], "scm_label": "", "sec_uid": "MS4wLjABAAAA3jFDUnObfQ46dsWci1xMiTGzkkUFvww0YLThyqVL3XWTvw6RhDBT8Bk8AsXagwMT", "secret": 0, "share_qrcode_uri": "", "special_id": "", "status": 1, "subscribe_info": { "anchor_gift_sub_auth": false, "badge": { "is_customized": false }, "enable_subscription": false, "is_in_grace_period": false, "is_sol_eligible": false, "is_subscribe": false, "is_subscribed_to_anchor": false, "package_id": "", "qualification": true, "sol_room_display_text": "", "status": 0, "sub_end_time": 0, "sub_split_status": { "cur_period": 3, "is_old_sub_creator": true }, "subscriber_count": 0, "timer_detail": { "anchor_id": 0, "anchor_side_title": "", "antidirt_status": 0, "audit_status": 0, "last_pause_timestamp_s": 0, "remaining_time_s": 0, "screen_h": 0, "screen_w": 0, "start_countdown_time_s": 0, "start_timestamp_s": 0, "sticker_x": 0, "sticker_y": 0, "sub_count": 0, "time_increase_cap_s": 0, "time_increase_per_sub_s": 0, "time_increase_reach_cap": false, "timer_id": 0, "timer_status": 0, "timestamp_s": 0, "total_pause_time_s": 0, "total_time_s": 0, "user_side_title": "" }, "user_gift_sub_auth": false }, "ticket_count": 0, "top_fans": [], "top_vip_no": 0, "upcoming_event_list": [], "user_attr": { "admin_permissions": { }, "has_voting_function": false, "is_admin": false, "is_channel_admin": false, "is_muted": false, "is_super_admin": false, "mute_duration": 0 }, "user_role": 0, "verified": false, "verified_content": "", "verified_reason": "", "with_car_management_permission": false, "with_commerce_permission": false, "with_fusion_shop_entry": false }, "owner_device_id": 0, "owner_device_id_str": "", "owner_user_id": 6.788752804346496e+18, "owner_user_id_str": "6788752804346496006", "paid_event": { "event_id": 0, "paid_type": 0 }, "partnership_info": { "game_info_list": [], "partnership_room": false, "promoting_drops_id": "", "promoting_game_id": "", "promoting_room": false, "promoting_task_id": "", "promoting_task_type": 0, "show_task_id": "", "show_task_type": 0, "task_id_list": [] }, "pico_live_type": 0, "polling_star_comment": false, "pre_enter_time": 0, "preview_flow_tag": 0, "quota_config": { }, "rank_comment_groups": [], "ranklist_audience_type": 0, "regional_restricted": { "block_list": [] }, "relation_tag": "", "replay": true, "repost_note": "", "reposted": false, "room_audit_status": 0, "room_auth": { "Banner": 1, "BroadcastMessage": 0, "Chat": true, "ChatL2": false, "ChatSubOnly": false, "CommentMention": 0, "CommercePermission": 0, "CommunityFlagged": false, "CommunityFlaggedReview": false, "CustomizableGiftPoll": 0, "CustomizablePoll": 0, "Danmaku": false, "Digg": true, "DonationSticker": 2, "EmotePoll": 0, "EnableFansLevel": false, "EnableShowUserUV": false, "EnigmaWhisper": 0, "EventPromotion": 0, "Explore": false, "GameRankingSwitch": 0, "Gift": true, "GiftAnchorMt": 1, "GiftPoll": 0, "GoldenEnvelope": 0, "GoldenEnvelopeActivity": 0, "InteractionQuestion": true, "Landscape": 2, "LandscapeChat": 0, "LuckMoney": true, "MultiEnableReserve": false, "Pictionary": 0, "PictionaryBubble": 0, "PictionaryPermission": 0, "Poll": 0, "Promote": false, "PromoteOther": 0, "Props": false, "PublicScreen": 1, "QuickChat": 0, "Rank": 0, "RankingChangeAlterSwitch": 0, "RoomContributor": false, "SecretRoom": 0, "Share": true, "ShareEffect": 0, "ShoppingRanking": 0, "SpamComments": false, "UserCard": true, "UserCount": 1, "ViewerWishes": 0, "Viewers": false, "anchor_level_permission": { "InteractionQuestion": 0, "beauty": 0, "comment_filter": 0, "comment_setting": 0, "customizable_poll": 0, "donation_sticker": 0, "effects": 0, "flip": 0, "full_screen_mode": 0, "goody_bag": 0, "hear_your_own_voice": 0, "karaoke": 0, "live_background": 0, "live_center": 0, "live_intro": 0, "mirror": 0, "moderator_setting": 0, "pause_live": 0, "pictionary": 0, "pin": 0, "play_together": 0, "poll": 0, "portal": 0, "promote": 0, "share": 0, "sticker": 0, "topic": 0, "treasure_box": 0, "viewer_rank_list": 0, "voice_effect": 0 }, "comment_tray_status": 0, "credit_entrance_for_audience": false, "deprecated1": false, "deprecated118": [], "deprecated119": 0, "deprecated2": 0, "deprecated3": 0, "deprecated4": 0, "deprecated5": 0, "deprecated6": 0, "deprecated7": 0, "deprecated8": 0, "deprecated9": 0, "game_guess_permission": false, "guess_entrance_for_host": false, "show_credit_widget": false, "transaction_history": 1, "use_user_pv": false }, "room_auth_message": { }, "room_create_ab_param": "{\"ai_live_summary\":0,\"auto_post_living\":0,\"autocut_opt_strategy_revert\":false,\"check_ping_no_streaming_short_close\":0,\"compensation_push\":0,\"count_strategy\":0,\"create_room_continue_optimize\":0,\"enable_revenue_tips_moderator_comment\":1,\"fans_privilege_upgrade\":1,\"game_multi_guess_creator\":1,\"game_use_new_virtual_app_id\":2,\"gb_obs_use_virtual_app_id\":0,\"gift_poll_optimize\":1,\"go_live_with_vip_stream\":0,\"heartme_gift_text_enabled\":true,\"host_lop_realtime_settle\":0,\"linkmic_ab_params\":{\"enable_effect_layout_animation\":true,\"enable_game_linkmic_charm\":true,\"linkmic_anchor_co_host_multi_guest_reservation\":1,\"linkmic_floating_layout_opt_style_v2\":2,\"live_linkmic_enable_state_consistency\":3,\"multi_guest_skip_tip_for_enlarge_another\":true},\"lite_user_not_visible\":false,\"live_cohost_cross_room_push_arch_enable\":true,\"live_cohost_timeout_strategy_group\":0,\"live_replay_highlight_recover\":false,\"live_replay_highlight_refactor\":0,\"live_share_post\":false,\"ls_auto_post\":0,\"moderator_tips_v2\":1,\"new_platform_badges\":false,\"obs_use_new_virtual_app_id\":0,\"pictionary_bubble\":0,\"pictionary_permission\":0,\"poll_template_optimize_group\":2,\"push_concurrency\":0,\"room_has_pin\":true,\"room_pin_duration\":60,\"sea_obs_use_virtual_app_id\":0,\"show_subscription_barrage_message\":false,\"show_subscription_enter_message\":false,\"sub_only_live_moderator\":false,\"update_room_status_optimize\":0,\"use_hybrid_golive_net\":0,\"use_new_anchor_net_control\":true,\"wave_optimize_strategy\":2}", "room_layout": 0, "room_llm_title": "", "room_pcu": 0, "room_sticker_list": [], "room_tabs": [], "room_tag": 0, "rtc_app_id": "", "scroll_config": "", "search_id": 0, "secret_room_access": false, "share_msg_style": 2, "share_url": "https://m.tiktok.com/share/live/7618370406579243792/?language=en&u_code=f0ja7h22380b90", "short_title": "", "short_touch_items": [], "show_emoji_list": false, "show_star_comment_entrance": false, "show_watch_live_cta": false, "social_interaction": { "linkmic_scene_linker": { }, "multi_live": { "ai_summary": "", "audience_send_gifts_to_all_enum": 0, "audience_shared_invitee_panel_type": 0, "background_sticker_id": "", "extra_info": { }, "hangout_card_tag_list": [], "host_gifter_linkmic_enum": 0, "host_multi_guest_dev_mode": 0, "host_send_gifts_to_all_enum": 0, "is_eligible_for_apply_auto_approve": false, "linkmic_service_version": 0, "top_live_guide": "", "top_live_title": "", "trigger_guide_time": 0, "try_open_multi_guest_when_create_room": false, "user_settings": { "applier_sort_gift_score_threshold": 0, "applier_sort_setting": 0, "multi_guest_allow_request_from_followers": 0, "multi_guest_allow_request_from_friends": 0, "multi_guest_allow_request_from_others": 0, "multi_guest_apply_auto_approve": 0, "multi_guest_disable_video_linkmic": 0, "multi_guest_reset_point_after_leave": 0, "multi_live_apply_permission": 1 }, "viewer_gifter_linkmic_enum": 0 } }, "square_cover_img": { "avg_color": "#666666", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "webcast-sg/0e36ad4b0ee9daf1a4fb22baebf0df72", "url_list": [ "https://p16-webcast.tiktokcdn.com/webcast-sg/0e36ad4b0ee9daf1a4fb22baebf0df72~tplv-obj.image", "https://p19-webcast.tiktokcdn.com/webcast-sg/0e36ad4b0ee9daf1a4fb22baebf0df72~tplv-obj.image" ], "width": 0 }, "start_time": 0, "stats": { "comment_count": 0, "deprecated1": 0, "deprecated2": "", "digg_count": 0, "enter_count": 191992, "fan_ticket": 0, "follow_count": 689, "gift_uv_count": 0, "id": 7.618370406579244e+18, "id_str": "7618370406579243792", "like_count": 0, "replay_fan_ticket": 0, "replay_viewers": 107976, "room_follow_count": 0, "share_count": 0, "total_user": 191992, "total_user_desp": "", "user_count_composition": { "deprecated1": 0, "my_follow": 0, "other": 0, "video_detail": 0 }, "watch_user_count": 0, "watermelon": 0 }, "status": 2, "sticker_list": [], "stream_id": 1.848419295776211e+18, "stream_id_str": "1848419295776211036", "stream_status": 0, "stream_url": { "alive_timestamp": 0, "candidate_resolution": [ "SD1", "SD2", "HD1" ], "complete_push_urls": [], "default_resolution": "SD2", "drm_type": 0, "extra": { "anchor_client_info": { "custom_info": "" }, "anchor_interact_profile": 0, "audience_interact_profile": 0, "bframe_enable": false, "bitrate_adapt_strategy": 0, "bytevc1_enable": false, "default_bitrate": 0, "deprecated1": false, "fps": 0, "gop_sec": 0, "hardware_encode": false, "height": 0, "max_bitrate": 0, "min_bitrate": 0, "roi": false, "sw_roi": false, "video_profile": 0, "width": 0 }, "flv_pull_url": { "HD1": "https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd.flv?expire=1775016070&sign=1080e4ca548bd5f82ef571cc85903bc1", "SD1": "https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_ld.flv?expire=1775016070&sign=45db48801206d7678e31a57f99e25e0e", "SD2": "https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_sd.flv?expire=1775016070&sign=1f972a9f3ffee9e3e11fc53bc8901573" }, "flv_pull_url_params": { "HD1": "{\"v_rtbitrate\":1761760,\"v_rtbitrate_std\":62560,\"v_rtpsnr\":0,\"v_rtbitrate_pct\":1853390,\"stream_suffix\":\"hd\",\"vbitrate\":1800000,\"resolution\":\"720x1280\",\"gop\":4,\"v_rtbitrate_vpaas_timestamp\":1773806470278,\"VCodec\":\"h264\",\"Auto\":{\"Enable\":1,\"Demotion\":{\"StallCount\":4}},\"v_rtbitrate_timestamp\":1773806467018,\"cdn_name\":\"ws\"}", "SD1": "{\"v_rtbitrate_vpaas_timestamp\":1773806470278,\"v_rtbitrate_timestamp\":1773806459089,\"gop\":4,\"v_rtbitrate\":531520,\"cdn_name\":\"ws\",\"stream_suffix\":\"ld\",\"vbitrate\":600000,\"v_rtpsnr\":0,\"Auto\":{\"Demotion\":{\"StallCount\":4},\"Enable\":1},\"VCodec\":\"h264\",\"v_rtbitrate_pct\":569430,\"v_rtbitrate_std\":23930,\"resolution\":\"360x640\"}", "SD2": "{\"Auto\":{\"Demotion\":{\"StallCount\":4},\"Enable\":1},\"VCodec\":\"h264\",\"v_rtbitrate_timestamp\":1773793805044,\"gop\":4,\"v_rtbitrate_pct\":1227160,\"cdn_name\":\"ws\",\"resolution\":\"540x960\",\"stream_suffix\":\"sd\",\"v_rtbitrate\":1184740,\"v_rtpsnr\":0,\"v_rtbitrate_std\":137180,\"vbitrate\":1200000,\"v_rtbitrate_vpaas_timestamp\":1773806470278}" }, "hls_pull_url": "https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036/playlist.m3u8?expire=1775016070&session_id=148-2026031812011014795160E4D0EB490726&sign=6c52550fdc11d0e2afd49c3a50c66e4f", "hls_pull_url_map": { }, "hls_pull_url_params": "{\"resolution\":\"1080x1920\",\"gop\":4,\"cdn_name\":\"ws\",\"VCodec\":\"h264\",\"Auto\":{\"Demotion\":{\"StallCount\":4},\"Enable\":1},\"vbitrate\":8400000}", "id": 1.848419295776211e+18, "id_str": "1848419295776211036", "live_core_sdk_data": { "pull_data": { "options": { "default_preview_quality": { "icon_type": 0, "level": 0, "name": "", "resolution": "", "sdk_key": "", "v_codec": "" }, "default_quality": { "icon_type": 0, "level": 0, "name": "540p", "resolution": "", "sdk_key": "sd", "v_codec": "" }, "qualities": [ { "icon_type": 6, "level": 10, "name": "Original", "resolution": "", "sdk_key": "origin", "v_codec": "" }, { "icon_type": 4, "level": 6, "name": "1080p60", "resolution": "", "sdk_key": "uhd_60", "v_codec": "" }, { "icon_type": 3, "level": 4, "name": "720p60", "resolution": "", "sdk_key": "hd_60", "v_codec": "" }, { "icon_type": 3, "level": 3, "name": "720p", "resolution": "", "sdk_key": "hd", "v_codec": "" }, { "icon_type": 2, "level": 2, "name": "540p", "resolution": "", "sdk_key": "sd", "v_codec": "" }, { "icon_type": 1, "level": 1, "name": "360p", "resolution": "", "sdk_key": "ld", "v_codec": "" } ], "show_quality_button": false, "support_low_latency": false }, "stream_data": "{\"common\":{\"session_id\":\"148-2026031812011014795160E4D0EB490726\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"default\\\\\\\",\\\\\\\"cdn\\\\\\\":192}}\\\"}\",\"user_count\":28,\"peer_anchor_level\":38},\"data\":{\"origin\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036.flv?expire=1775016070&sign=09f8f551ed25dd2492c1f36c21a99f5d\",\"hls\":\"https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036/playlist.m3u8?expire=1775016070&sign=6c52550fdc11d0e2afd49c3a50c66e4f\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"https://pull-lls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036.sdp?expire=1775016070&sign=676cf83b30b1f79eb93cc2a4c626243e\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"ws\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"vbitrate\\\":8400000}\"}},\"hd\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd.flv?expire=1775016070&sign=1080e4ca548bd5f82ef571cc85903bc1\",\"hls\":\"https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd/playlist.m3u8?expire=1775016070&sign=eb701676b389d80c687773b5e0f4d419\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"https://pull-lls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd.sdp?expire=1775016070&sign=944a5503d3db1a657b5894bfea67cdb8\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"v_rtbitrate\\\":1761760,\\\"v_rtbitrate_std\\\":62560,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_pct\\\":1853390,\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1800000,\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":4,\\\"v_rtbitrate_vpaas_timestamp\\\":1773806470278,\\\"VCodec\\\":\\\"h264\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"v_rtbitrate_timestamp\\\":1773806467018,\\\"cdn_name\\\":\\\"ws\\\"}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_sd.flv?expire=1775016070&sign=1f972a9f3ffee9e3e11fc53bc8901573\",\"hls\":\"https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_sd/playlist.m3u8?expire=1775016070&sign=0737058acd1428560b27d3aa1933e66d\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"https://pull-lls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_sd.sdp?expire=1775016070&sign=8ccbb3d0ca6b8919802a09c61fac80d2\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"VCodec\\\":\\\"h264\\\",\\\"v_rtbitrate_timestamp\\\":1773793805044,\\\"gop\\\":4,\\\"v_rtbitrate_pct\\\":1227160,\\\"cdn_name\\\":\\\"ws\\\",\\\"resolution\\\":\\\"540x960\\\",\\\"stream_suffix\\\":\\\"sd\\\",\\\"v_rtbitrate\\\":1184740,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_std\\\":137180,\\\"vbitrate\\\":1200000,\\\"v_rtbitrate_vpaas_timestamp\\\":1773806470278}\"}},\"ld\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_ld.flv?expire=1775016070&sign=45db48801206d7678e31a57f99e25e0e\",\"hls\":\"https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_ld/playlist.m3u8?expire=1775016070&sign=c7949cc1291b8291eb3bac99d16faf75\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"https://pull-lls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_ld.sdp?expire=1775016070&sign=4702087b577c98c27a1985fd05bd581d\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"v_rtbitrate_vpaas_timestamp\\\":1773806470278,\\\"v_rtbitrate_timestamp\\\":1773806459089,\\\"gop\\\":4,\\\"v_rtbitrate\\\":531520,\\\"cdn_name\\\":\\\"ws\\\",\\\"stream_suffix\\\":\\\"ld\\\",\\\"vbitrate\\\":600000,\\\"v_rtpsnr\\\":0,\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"VCodec\\\":\\\"h264\\\",\\\"v_rtbitrate_pct\\\":569430,\\\"v_rtbitrate_std\\\":23930,\\\"resolution\\\":\\\"360x640\\\"}\"}},\"uhd_60\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_uhd60.flv?expire=1775016070&sign=c5bffc91e7a5dcde535b3ded0af0fc7f\",\"hls\":\"https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_uhd60/playlist.m3u8?expire=1775016070&sign=e3095f367e0755890e81b9a6cc829399\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"https://pull-lls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_uhd60.sdp?expire=1775016070&sign=c3385b772371e0a70690034e1e075f15\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"gop\\\":4,\\\"cdn_name\\\":\\\"ws\\\",\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"VCodec\\\":\\\"h264\\\",\\\"stream_suffix\\\":\\\"uhd60\\\",\\\"vbitrate\\\":5000000,\\\"resolution\\\":\\\"1080x1920\\\"}\"}},\"hd_60\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd60.flv?expire=1775016070&sign=5dab7b121657e298c66ebf070f2fd97b\",\"hls\":\"https://pull-hls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd60/playlist.m3u8?expire=1775016070&sign=9c31fd6531305fed8fab68b87d2736d1\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"https://pull-lls-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036_hd60.sdp?expire=1775016070&sign=2d13eb7d1aa6a867368a81139211dfe0\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"resolution\\\":\\\"720x1280\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"VCodec\\\":\\\"h264\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"ws\\\",\\\"stream_suffix\\\":\\\"hd60\\\",\\\"vbitrate\\\":3000000}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036.flv?expire=1775016070&sign=09f8f551ed25dd2492c1f36c21a99f5d&only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"ws\\\",\\\"stream_suffix\\\":\\\"ao\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"VCodec\\\":\\\"h264\\\"}\"}}}}" }, "push_data": { "push_stream_level": 0, "resolution_params": { }, "stream_data": "" } }, "provider": 0, "push_resolution": "", "push_urls": [], "resolution_name": { "AUTO": "AUTO", "FULL_HD1": "1080p", "HD1": "720p", "ORIGION": "Original", "SD1": "360p", "SD2": "540p", "pm_mt_video_1080p60": "1080p60", "pm_mt_video_720p60": "720p60", "ttlive_videoQuality_option_2k": "2K" }, "rtmp_pull_url": "https://pull-flv-l1-sg01.tiktokcdn.com/game/stream-1848419295776211036.flv?expire=1775016070&session_id=148-2026031812011014795160E4D0EB490726&sign=09f8f551ed25dd2492c1f36c21a99f5d", "rtmp_pull_url_params": "{\"resolution\":\"1080x1920\",\"gop\":4,\"cdn_name\":\"ws\",\"VCodec\":\"h264\",\"Auto\":{\"Demotion\":{\"StallCount\":4},\"Enable\":1},\"vbitrate\":8400000}", "rtmp_push_url": "", "rtmp_push_url_params": "", "stream_app_id": 0, "stream_control_type": 0, "stream_delay_ms": 0, "stream_size_height": 0, "stream_size_width": 0, "vr_type": 0 }, "stream_url_filtered_info": { "is_gated_room": false, "is_paid_event": false }, "sub_tag": 0, "support_quiz": 0, "title": "cuenta mr stiven", "top_fans": [ { "fan_ticket": 5889, "user": { "allow_find_by_contacts": false, "allow_others_download_video": false, "allow_others_download_when_sharing_video": false, "allow_share_show_profile": false, "allow_show_in_gossip": false, "allow_show_my_action": false, "allow_strange_comment": false, "allow_unfollower_comment": false, "allow_use_linkmic": false, "avatar_large": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "1080x1080/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=dfdaf54d&x-expires=1773979200&x-signature=LQNU09FUguxUMw%2FVrRXiFiiN1yg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=266738ac&x-expires=1773979200&x-signature=jRvB1kfzaqZuRaNaxTdJzgOrhQY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3" ], "width": 0 }, "avatar_medium": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "720x720/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=3cfb12a8&x-expires=1773979200&x-signature=XkLkxxZZxm9LN8EKw4omBHIuWDQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=939d166f&x-expires=1773979200&x-signature=ukG%2Fh8jRU5HCbDokYXq7DFGYEi0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3" ], "width": 0 }, "avatar_thumb": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "100x100/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=914829a8&x-expires=1773979200&x-signature=FqLSj1ywnkyxKyHV1tl6KleqV%2FU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/4eecc69819032da43be65480298de70f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=2743c2a2&x-expires=1773979200&x-signature=z5PhTUb6oI9W%2BFh609cquNwipF0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3" ], "width": 0 }, "badge_image_list": [], "badge_list": [], "bg_img_url": "", "bio_description": "", "block_status": 0, "border_list": [], "comment_restrict": 0, "commerce_webcast_config_ids": [], "constellation": "", "create_time": 0, "deprecated1": 0, "deprecated12": 0, "deprecated13": 0, "deprecated15": 0, "deprecated16": false, "deprecated17": false, "deprecated18": "", "deprecated19": false, "deprecated2": 0, "deprecated21": 0, "deprecated28": false, "deprecated29": "", "deprecated3": 0, "deprecated4": 0, "deprecated5": "", "deprecated6": 0, "deprecated7": "", "deprecated8": 0, "disable_ichat": 0, "display_id": "kevin_zx.07", "enable_ichat_img": 0, "exp": 0, "fan_ticket_count": 0, "fold_stranger_chat": false, "follow_info": { "follow_status": 0, "follower_count": 308, "following_count": 175, "push_status": 0 }, "follow_status": 0, "ichat_restrict_type": 0, "id": 7.519324647486572e+18, "id_str": "7519324647486571551", "is_anchor_marked": false, "is_block": false, "is_follower": false, "is_following": false, "is_subscribe": false, "link_mic_stats": 2, "media_badge_image_list": [], "mint_type_label": [], "modify_time": 1773800828, "need_profile_guide": false, "new_real_time_icons": [], "nickname": "J E O V A N Y 🩸", "pay_grade": { "deprecated20": 0, "deprecated22": 0, "deprecated23": 0, "deprecated24": 0, "deprecated25": 0, "deprecated26": 0, "grade_banner": "", "grade_describe": "", "grade_icon_list": [], "level": 0, "name": "", "next_name": "", "next_privileges": "", "score": 0, "screen_chat_type": 0, "upgrade_need_consume": 0 }, "pay_score": 0, "pay_scores": 0, "push_comment_status": false, "push_digg": false, "push_follow": false, "push_friend_action": false, "push_ichat": false, "push_status": false, "push_video_post": false, "push_video_recommend": false, "real_time_icons": [], "scm_label": "", "sec_uid": "MS4wLjABAAAAg4U7YuAaJLK69yPHDJt73idcP9m2z8bN8nzLyoDkkM_SFZTXskWugRri5hgW6vUl", "secret": 0, "share_qrcode_uri": "", "special_id": "", "status": 1, "ticket_count": 0, "top_fans": [], "top_vip_no": 0, "upcoming_event_list": [], "user_attr": { "admin_permissions": { }, "has_voting_function": false, "is_admin": false, "is_channel_admin": false, "is_muted": false, "is_super_admin": false, "mute_duration": 0 }, "user_role": 0, "verified": false, "verified_content": "", "verified_reason": "", "with_car_management_permission": false, "with_commerce_permission": false, "with_fusion_shop_entry": false } }, { "fan_ticket": 1829, "user": { "allow_find_by_contacts": false, "allow_others_download_video": false, "allow_others_download_when_sharing_video": false, "allow_share_show_profile": false, "allow_show_in_gossip": false, "allow_show_my_action": false, "allow_strange_comment": false, "allow_unfollower_comment": false, "allow_use_linkmic": false, "avatar_large": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "1080x1080/tos-maliva-avt-0068/0467a87bac511970395365c863688481", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0467a87bac511970395365c863688481~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=bbf0b099&x-expires=1773975600&x-signature=INwW5XDPpT3gNxD01kyrek8pOb0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0467a87bac511970395365c863688481~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=6085a909&x-expires=1773975600&x-signature=%2Brza%2FrMeTskGCLfptQU9%2FPxkJck%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2" ], "width": 0 }, "avatar_medium": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "720x720/tos-maliva-avt-0068/0467a87bac511970395365c863688481", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0467a87bac511970395365c863688481~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=40e50c79&x-expires=1773975600&x-signature=mphVRed5OGl%2FKZ7w47C%2F4pBFPUo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0467a87bac511970395365c863688481~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=a84e571f&x-expires=1773975600&x-signature=ryLh2MDbTKuFsiWpgnW9nTQkR5U%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2" ], "width": 0 }, "avatar_thumb": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "100x100/tos-maliva-avt-0068/0467a87bac511970395365c863688481", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0467a87bac511970395365c863688481~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=0cf75c75&x-expires=1773975600&x-signature=RHfGSUcP71lEVbhXI64PKlzyYu4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/0467a87bac511970395365c863688481~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=f3f36690&x-expires=1773975600&x-signature=K8JkJdSEGQX25Nxzh8iRuKrdyiw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2" ], "width": 0 }, "badge_image_list": [], "badge_list": [ { "OpenWebURL": "aweme://roma_redirect/?spark_page=user_level_main_page_privilege_panel", "combine": { "background": { "background_color_code": "#B3475AFF", "border_color_code": "", "image": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "", "url_list": [], "width": 0 }, "left_side_image": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "", "url_list": [], "width": 0 } }, "background_auto_mirrored": false, "background_dark_mode": { "background_color_code": "#B3475AFF", "border_color_code": "", "image": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "", "url_list": [], "width": 0 }, "left_side_image": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "", "url_list": [], "width": 0 } }, "display_type": 4, "font_style": { "border_color": "", "font_color": "", "font_size": 0, "font_width": 0 }, "icon": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "aweme://roma_redirect/?spark_page=user_level_main_page_privilege_panel", "uri": "webcast-va/grade_badge_icon_lite_lv20_v1.png", "url_list": [ "https://p16-webcast.tiktokcdn.com/webcast-va/grade_badge_icon_lite_lv20_v1.png~tplv-obj.image", "https://p19-webcast.tiktokcdn.com/webcast-va/grade_badge_icon_lite_lv20_v1.png~tplv-obj.image" ], "width": 0 }, "icon_auto_mirrored": false, "multi_guest_show_style": 0, "padding": { "badge_width": 32, "horizontal_padding_rule": 0, "icon_bottom_padding": 0, "icon_top_padding": 0, "left_padding": 0, "middle_padding": 0, "right_padding": 0, "use_specific": true, "vertical_padding_rule": 0 }, "padding_new_font": { "badge_width": 32, "horizontal_padding_rule": 0, "icon_bottom_padding": 0, "icon_top_padding": 0, "left_padding": 0, "middle_padding": 0, "right_padding": 0, "use_specific": true, "vertical_padding_rule": 0 }, "personal_card_show_style": 15, "profile_card_panel": { "badge_text_position": 0, "profile_content": { "icon_list": [], "use_content": false }, "projection_config": { "icon": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "", "url_list": [], "width": 0 }, "use_projection": false }, "use_new_profile_card_style": false }, "public_screen_show_style": 14, "ranklist_online_audience_show_style": 0, "str": "22" }, "display": true, "display_status": 0, "display_type": 4, "exhibition_type": 0, "greyed_by_client": 0, "is_customized": false, "position": 1, "priority_type": 20, "privilege_log_extra": { "data_version": "2", "end_time": 0, "level": "22", "privilege_id": "7138381861675357988", "privilege_order_id": "mock_fix_width_transparent_7138381861675357988", "privilege_version": "0", "start_time": 0 }, "scene_type": 8 } ], "bg_img_url": "", "bio_description": "", "block_status": 0, "border_list": [], "comment_restrict": 0, "commerce_webcast_config_ids": [], "constellation": "", "create_time": 0, "deprecated1": 0, "deprecated12": 0, "deprecated13": 0, "deprecated15": 0, "deprecated16": false, "deprecated17": false, "deprecated18": "", "deprecated19": false, "deprecated2": 0, "deprecated21": 0, "deprecated28": false, "deprecated29": "", "deprecated3": 0, "deprecated4": 0, "deprecated5": "", "deprecated6": 0, "deprecated7": "", "deprecated8": 0, "disable_ichat": 0, "display_id": "ivan.a.borbon", "enable_ichat_img": 0, "exp": 0, "fan_ticket_count": 0, "fold_stranger_chat": false, "follow_info": { "follow_status": 0, "follower_count": 80, "following_count": 224, "push_status": 0 }, "follow_status": 0, "ichat_restrict_type": 0, "id": 6.838241872218359e+18, "id_str": "6838241872218358789", "is_anchor_marked": false, "is_block": false, "is_follower": false, "is_following": false, "is_subscribe": false, "link_mic_stats": 2, "media_badge_image_list": [], "mint_type_label": [7.160893592603462e+18], "modify_time": 1773769839, "need_profile_guide": false, "new_real_time_icons": [], "nickname": "Shenrro", "pay_grade": { "deprecated20": 0, "deprecated22": 0, "deprecated23": 0, "deprecated24": 0, "deprecated25": 0, "deprecated26": 0, "grade_banner": "", "grade_describe": "", "grade_icon_list": [], "level": 0, "name": "", "next_name": "", "next_privileges": "", "score": 0, "screen_chat_type": 0, "upgrade_need_consume": 0 }, "pay_score": 0, "pay_scores": 0, "push_comment_status": false, "push_digg": false, "push_follow": false, "push_friend_action": false, "push_ichat": false, "push_status": false, "push_video_post": false, "push_video_recommend": false, "real_time_icons": [], "scm_label": "", "sec_uid": "MS4wLjABAAAAA6-mF5-rk3cfvimJwN1t4AGPbXpsgMqF5Xi0NaoK937ZU7-W-qBEW9mx29qACZ70", "secret": 1, "share_qrcode_uri": "", "special_id": "", "status": 1, "ticket_count": 0, "top_fans": [], "top_vip_no": 0, "upcoming_event_list": [], "user_attr": { "admin_permissions": { }, "has_voting_function": false, "is_admin": false, "is_channel_admin": false, "is_muted": false, "is_super_admin": false, "mute_duration": 0 }, "user_role": 0, "verified": false, "verified_content": "", "verified_reason": "", "with_car_management_permission": false, "with_commerce_permission": false, "with_fusion_shop_entry": false } }, { "fan_ticket": 1107, "user": { "allow_find_by_contacts": false, "allow_others_download_video": false, "allow_others_download_when_sharing_video": false, "allow_share_show_profile": false, "allow_show_in_gossip": false, "allow_show_my_action": false, "allow_strange_comment": false, "allow_unfollower_comment": false, "allow_use_linkmic": false, "avatar_large": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "1080x1080/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=0f1c5e7c&x-expires=1773979200&x-signature=%2B2xuFvHOYKm3ExXq5jCT%2BIl8GzY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=12734165&x-expires=1773979200&x-signature=jqV9CyQkIOnOcJoYcWhir8puNOg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3" ], "width": 0 }, "avatar_medium": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "720x720/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=39ddc11d&x-expires=1773979200&x-signature=HVqVecS7AmYVesEk3h8wxM1w3sw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9c433d7c&x-expires=1773979200&x-signature=5lhVy%2F71A%2FkFRZhAT9NGvyXHtPE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3" ], "width": 0 }, "avatar_thumb": { "avg_color": "", "height": 0, "image_type": 0, "is_animated": false, "open_web_url": "", "uri": "100x100/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e", "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=192ba954&x-expires=1773979200&x-signature=JTi9HAa%2B8N5IwE6jyVnBGA3bupU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c280efb15ed5032ccc498e6815b1906e~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=488b4da9&x-expires=1773979200&x-signature=URvXbsCrc5gTeGu2m3n%2F3aQiDgI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my3" ], "width": 0 }, "badge_image_list": [], "badge_list": [], "bg_img_url": "", "bio_description": "👩🏽‍🦱💕", "block_status": 0, "border_list": [], "comment_restrict": 0, "commerce_webcast_config_ids": [], "constellation": "", "create_time": 0, "deprecated1": 0, "deprecated12": 0, "deprecated13": 0, "deprecated15": 0, "deprecated16": false, "deprecated17": false, "deprecated18": "", "deprecated19": false, "deprecated2": 0, "deprecated21": 0, "deprecated28": false, "deprecated29": "", "deprecated3": 0, "deprecated4": 0, "deprecated5": "", "deprecated6": 0, "deprecated7": "", "deprecated8": 0, "disable_ichat": 0, "display_id": "rxxnal", "enable_ichat_img": 0, "exp": 0, "fan_ticket_count": 0, "fold_stranger_chat": false, "follow_info": { "follow_status": 0, "follower_count": 41, "following_count": 161, "push_status": 0 }, "follow_status": 0, "ichat_restrict_type": 0, "id": 7.471332853295302e+18, "id_str": "7471332853295301678", "is_anchor_marked": false, "is_block": false, "is_follower": false, "is_following": false, "is_subscribe": false, "link_mic_stats": 2, "media_badge_image_list": [], "mint_type_label": [], "modify_time": 1773760849, "need_profile_guide": false, "new_real_time_icons": [], "nickname": "rxxnal", "pay_grade": { "deprecated20": 0, "deprecated22": 0, "deprecated23": 0, "deprecated24": 0, "deprecated25": 0, "deprecated26": 0, "grade_banner": "", "grade_describe": "", "grade_icon_list": [], "level": 0, "name": "", "next_name": "", "next_privileges": "", "score": 0, "screen_chat_type": 0, "upgrade_need_consume": 0 }, "pay_score": 0, "pay_scores": 0, "push_comment_status": false, "push_digg": false, "push_follow": false, "push_friend_action": false, "push_ichat": false, "push_status": false, "push_video_post": false, "push_video_recommend": false, "real_time_icons": [], "scm_label": "", "sec_uid": "MS4wLjABAAAAq3fHx1yjd1uHT_8hNsbACsmMsPvfbIZlzmWknh35Z4U1e98aepk-j_H_-orjJoV4", "secret": 0, "share_qrcode_uri": "", "special_id": "", "status": 1, "ticket_count": 0, "top_fans": [], "top_vip_no": 0, "upcoming_event_list": [], "user_attr": { "admin_permissions": { }, "has_voting_function": false, "is_admin": false, "is_channel_admin": false, "is_muted": false, "is_super_admin": false, "mute_duration": 0 }, "user_role": 0, "verified": false, "verified_content": "", "verified_reason": "", "with_car_management_permission": false, "with_commerce_permission": false, "with_fusion_shop_entry": false } } ], "use_filter": false, "user_count": 1925, "user_share_text": "", "video_feed_tag": "", "visible_scope_type": 0, "watch_day_cnt_layer": 0, "watch_early_quota_config": { }, "webcast_comment_tcs": 0, "webcast_sdk_version": 0, "with_draw_something": false, "with_ktv": false, "with_linkmic": true } }, "status_code": { "type": "number", "description": "", "example": 0 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiLiveInfo", "tags": [ "Live" ], "parameters": [ { "in": "query", "name": "roomId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Room ID. You can get the roomId from the uniqueId via the `api/live/check-alive` endpoint (room_id_str)", "example": "7618370406579243792" }, "required": true } ], "summary": "Get Live Info", "description": "Get Live Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/live/category": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "is_not_show_tab": { "type": "boolean", "description": "", "example": false }, "sub_tabs": { "type": "array", "items": { "type": "object", "properties": { "cover_url": { "type": "string", "description": "", "example": "https://p16-webcast.tiktokcdn.com/img/alisg/webcast-sg/drawer_tab_cover_chatting.png~tplv-obj.image" }, "potition": { "type": "number", "description": "", "example": 0 }, "rank_type": { "type": "string", "description": "", "example": "" }, "tab_name": { "type": "string", "description": "", "example": "Chats" }, "tab_type": { "type": "string", "description": "", "example": "chatting" }, "viewer_count": { "type": "number", "description": "", "example": 2151381 } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiLiveCategory", "tags": [ "Live" ], "parameters": [], "summary": "Get Live Category", "description": "Get Live Category", "security": [ { "apiKeyAuth": [] } ] } }, "/api/live/stream": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "number", "description": "", "example": 1 }, "rid": { "type": "string", "description": "", "example": "202511261146385B52B0067EF79A29CAAB" }, "data": { "type": "object", "properties": { "id": { "type": "number", "description": "", "example": 7.576979804700872e+18 }, "id_str": { "type": "string", "description": "", "example": "7576979804700871480" }, "status": { "type": "number", "description": "", "example": 2 }, "owner_user_id": { "type": "number", "description": "", "example": 7.250513045330363e+18 }, "title": { "type": "string", "description": "", "example": "SAB PRO MAX ROBLOX LIVE" }, "user_count": { "type": "number", "description": "", "example": 1542 }, "client_version": { "type": "number", "description": "", "example": 9704 }, "cover": { "type": "object", "properties": { "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/8df3e54cdf53c1952515414cd051f5e1~tplv-tiktokx-cropcenter:720:720.webp?dr=10399&refresh_token=6974a24a&x-expires=1764324000&x-signature=FNYvIfMku1v%2FByzTvu7RJKeqBr4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=no1a", "https://p9-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/8df3e54cdf53c1952515414cd051f5e1~tplv-tiktokx-cropcenter:720:720.webp?dr=10399&refresh_token=de8c577a&x-expires=1764324000&x-signature=Ph86etMhA2N6K49LSlAGFhFgpYQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=no1a", "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/8df3e54cdf53c1952515414cd051f5e1~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=aaf95b01&x-expires=1764324000&x-signature=tEI0PeqwEhohV01Iy%2B7Fs6fZSsw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=no1a" ] }, "uri": { "type": "string", "description": "", "example": "720x720/tos-alisg-avt-0068/8df3e54cdf53c1952515414cd051f5e1" } } }, "stream_url": { "type": "object", "properties": { "extra": { "type": "object", "description": "", "example": { } }, "rtmp_pull_url": { "type": "string", "description": "", "example": "https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080.flv?expire=1765367198&session_id=056-202511261146385B52B0067EF79A29CAAB&sign=ded5fb3d3cc7aeb7bf5a939760640c68" }, "flv_pull_url": { "type": "object", "properties": { "HD1": { "type": "string", "description": "", "example": "https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_hd5.flv?expire=1765367198&sign=f0ca7188801276dde918446e98fa9224" }, "SD2": { "type": "string", "description": "", "example": "https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_sd5.flv?expire=1765367198&sign=482e5863e0691626076453cab6b53fdf" }, "SD1": { "type": "string", "description": "", "example": "https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_ld5.flv?expire=1765367198&sign=a97a757db7c64f281aa017c8bae603d7" } } }, "flv_pull_url_params": { "type": "object", "properties": { "HD1": { "type": "string", "description": "", "example": "{\"Auto\":{\"Enable\":1,\"Demotion\":{\"StallCount\":4}},\"cdn_name\":\"fcdn\",\"v_rtpsnr\":0,\"stream_suffix\":\"hd5\",\"v_rtbitrate_std\":28680,\"v_rtbitrate_pct\":1604090,\"v_rtbitrate_vpaas_timestamp\":1764157598551,\"vbitrate\":1600000,\"VCodec\":\"h265\",\"resolution\":\"720x1280\",\"gop\":4,\"v_rtbitrate\":1573230,\"v_rtbitrate_timestamp\":1764157575056}" }, "SD2": { "type": "string", "description": "", "example": "{\"gop\":4,\"v_rtbitrate_std\":17790,\"VCodec\":\"h265\",\"v_rtbitrate_pct\":1145660,\"vbitrate\":1000000,\"cdn_name\":\"fcdn\",\"v_rtpsnr\":0,\"v_rtbitrate_timestamp\":1764157578031,\"v_rtbitrate_vpaas_timestamp\":1764157598551,\"v_rtbitrate\":1130960,\"Auto\":{\"Enable\":1,\"Demotion\":{\"StallCount\":4}},\"stream_suffix\":\"sd5\",\"resolution\":\"540x960\"}" }, "SD1": { "type": "string", "description": "", "example": "{\"v_rtbitrate_std\":63680,\"vbitrate\":600000,\"v_rtbitrate_vpaas_timestamp\":1764157598551,\"Auto\":{\"Enable\":1,\"Demotion\":{\"StallCount\":4}},\"VCodec\":\"h265\",\"gop\":4,\"cdn_name\":\"fcdn\",\"v_rtbitrate_timestamp\":1764157537030,\"v_rtbitrate\":601270,\"stream_suffix\":\"ld5\",\"v_rtpsnr\":0,\"resolution\":\"360x640\",\"v_rtbitrate_pct\":631880}" } } }, "live_core_sdk_data": { "type": "object", "properties": { "pull_data": { "type": "object", "properties": { "stream_data": { "type": "string", "description": "", "example": "{\"common\":{\"session_id\":\"056-202511261146385B52B0067EF79A29CAAB\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":1813},\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_31553(Weight:100)\\\\\\\"]}\\\"}\",\"user_count\":1442,\"peer_anchor_level\":36},\"data\":{\"ld\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_ld5.flv?expire=1765367198&sign=a97a757db7c64f281aa017c8bae603d7\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"v_rtbitrate_std\\\":63680,\\\"vbitrate\\\":600000,\\\"v_rtbitrate_vpaas_timestamp\\\":1764157598551,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"VCodec\\\":\\\"h265\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate_timestamp\\\":1764157537030,\\\"v_rtbitrate\\\":601270,\\\"stream_suffix\\\":\\\"ld5\\\",\\\"v_rtpsnr\\\":0,\\\"resolution\\\":\\\"360x640\\\",\\\"v_rtbitrate_pct\\\":631880}\"}},\"uhd_60\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_uhd560.flv?expire=1765367198&sign=73aa3bbb43db7e96ea615082d101e1ae\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"vbitrate\\\":4000000,\\\"v_rtbitrate\\\":3014080,\\\"v_rtbitrate_vpaas_timestamp\\\":1764157598551,\\\"stream_suffix\\\":\\\"uhd560\\\",\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_pct\\\":3104410,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate_timestamp\\\":1764157589036,\\\"VCodec\\\":\\\"h265\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"resolution\\\":\\\"1080x1920\\\",\\\"v_rtbitrate_std\\\":89100,\\\"gop\\\":4}\"}},\"hd_60\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_hd560.flv?expire=1765367198&sign=ac873c700d0184762779749faf2c4b23\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"v_rtbitrate_timestamp\\\":1764157574030,\\\"stream_suffix\\\":\\\"hd560\\\",\\\"v_rtbitrate_vpaas_timestamp\\\":1764157598551,\\\"v_rtbitrate_std\\\":108160,\\\"vbitrate\\\":2600000,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate\\\":2578730,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_pct\\\":2775370,\\\"resolution\\\":\\\"720x1280\\\"}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080.flv?expire=1765367198&sign=ded5fb3d3cc7aeb7bf5a939760640c68&only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"VCodec\\\":\\\"h264\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4}\"}},\"origin\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080.flv?expire=1765367198&sign=ded5fb3d3cc7aeb7bf5a939760640c68\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"vbitrate\\\":4000000,\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"}},\"hd\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_hd5.flv?expire=1765367198&sign=f0ca7188801276dde918446e98fa9224\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtpsnr\\\":0,\\\"stream_suffix\\\":\\\"hd5\\\",\\\"v_rtbitrate_std\\\":28680,\\\"v_rtbitrate_pct\\\":1604090,\\\"v_rtbitrate_vpaas_timestamp\\\":1764157598551,\\\"vbitrate\\\":1600000,\\\"VCodec\\\":\\\"h265\\\",\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":4,\\\"v_rtbitrate\\\":1573230,\\\"v_rtbitrate_timestamp\\\":1764157575056}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-w5-va01.fcdn.eu.tiktokcdn.com/game/stream-3000694072734122080_sd5.flv?expire=1765367198&sign=482e5863e0691626076453cab6b53fdf\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"gop\\\":4,\\\"v_rtbitrate_std\\\":17790,\\\"VCodec\\\":\\\"h265\\\",\\\"v_rtbitrate_pct\\\":1145660,\\\"vbitrate\\\":1000000,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_timestamp\\\":1764157578031,\\\"v_rtbitrate_vpaas_timestamp\\\":1764157598551,\\\"v_rtbitrate\\\":1130960,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"stream_suffix\\\":\\\"sd5\\\",\\\"resolution\\\":\\\"540x960\\\"}\"}}}}" }, "options": { "type": "object", "properties": { "default_quality": { "type": "object", "description": "", "example": { } }, "default_preview_quality": { "type": "object", "description": "", "example": { } } } } } }, "push_data": { "type": "object", "description": "", "example": { } } } }, "stream_size_width": { "type": "number", "description": "", "example": 1080 }, "stream_size_height": { "type": "number", "description": "", "example": 1920 } } }, "link_mic": { "type": "object", "properties": { "channel_info": { "type": "object", "description": "", "example": { } }, "battle_settings": { "type": "object", "description": "", "example": { } } } }, "stats": { "type": "object", "properties": { "total_user": { "type": "number", "description": "", "example": 71492 }, "user_count_composition": { "type": "object", "description": "", "example": { } }, "enter_count": { "type": "number", "description": "", "example": 71492 }, "share_count": { "type": "number", "description": "", "example": 107 }, "comment_count": { "type": "number", "description": "", "example": 27891 } } }, "feed_room_label": { "type": "object", "description": "", "example": { } }, "living_room_attrs": { "type": "object", "description": "", "example": { } }, "owner": { "type": "object", "properties": { "id": { "type": "number", "description": "User ID", "example": 7.250513045330363e+18 }, "nickname": { "type": "string", "description": "", "example": "PAJ PH on YT" }, "bio_description": { "type": "string", "description": "", "example": "FB Page: PAJ PH\nYT Channel" }, "avatar_thumb": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] } } }, "avatar_medium": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] } } }, "avatar_large": { "type": "object", "properties": { "uri": { "type": "string", "description": "", "example": "tos-useast5-avt-0068-tx/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example1.webp", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/example2.jpeg" ] } } }, "status": { "type": "number", "description": "", "example": 1 }, "modify_time": { "type": "number", "description": "", "example": 11764153134 }, "follow_info": { "type": "object", "properties": { "following_count": { "type": "number", "description": "", "example": 145 }, "follower_count": { "type": "number", "description": "", "example": 449318 } } }, "pay_grade": { "type": "object", "description": "", "example": { } }, "user_attr": { "type": "object", "description": "", "example": { } }, "own_room": { "type": "object", "properties": { "room_ids": { "type": "array", "items": { "type": "number" }, "description": "", "example": [7.576979804700872e+18] }, "room_ids_str": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "7576979804700871480" ] } } }, "link_mic_stats": { "type": "number", "description": "", "example": 2 }, "display_id": { "type": "string", "description": "User uniqueId", "example": "papipajph" }, "sec_uid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAA8YEV6h4pKWI2TW-kC58Nr_7bqb6Mgd6ObFPcodpkG3Dbus6HcAC1J7ln2mwJslH9" }, "mint_type_label": { "type": "array", "items": { "type": "number" }, "description": "", "example": [6.717062916320791e+18] }, "id_str": { "type": "string", "description": "", "example": "7250513045330363397" } } }, "live_type_third_party": { "type": "boolean", "description": "", "example": true }, "room_auth": { "type": "object", "description": "", "example": { } }, "like_count": { "type": "number", "description": "", "example": 774941 }, "anchor_tab_type": { "type": "number", "description": "", "example": 7 }, "commerce_info": { "type": "object", "description": "", "example": { } }, "hashtag": { "type": "object", "description": "", "example": { } }, "live_room_mode": { "type": "number", "description": "", "example": 6 }, "stream_url_filtered_info": { "type": "object", "description": "", "example": { } }, "social_interaction": { "type": "object", "description": "", "example": { } }, "square_cover_img": { "type": "object", "description": "", "example": { } }, "rectangle_cover_img": { "type": "object", "description": "", "example": { } }, "room_auth_message": { "type": "object", "description": "", "example": { } }, "age_restricted": { "type": "object", "description": "", "example": { } }, "blurred_cover": { "type": "object", "description": "", "example": { } }, "multi_stream_url": { "type": "object", "description": "", "example": { } }, "cover_type": { "type": "number", "description": "", "example": 1 }, "game_tag_detail": { "type": "object", "description": "", "example": { } }, "preview_comment_info": { "type": "object", "description": "", "example": { } }, "taxonomy_tag_info": { "type": "object", "description": "", "example": { } }, "stream_snapshot": { "type": "object", "description": "", "example": { } } } }, "flare_info": { "type": "object", "description": "", "example": { } }, "room_event_tracking": { "type": "string", "description": "", "example": "pc_web_game_category_feed_loadmore:1111009:normal" } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiLiveStream", "tags": [ "Live" ], "parameters": [ { "in": "query", "name": "related_live_tag", "schema": { "type": "string", "minLength": 1, "description": "Related Live Tag", "example": "Roblox" }, "required": true } ], "summary": "Get Live Stream", "description": "Get Live Stream (Related Live Tag)", "security": [ { "apiKeyAuth": [] } ] } }, "/api/live/check-alive": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "alive": { "type": "boolean", "description": "Indicates whether the user is currently livestreaming", "example": false }, "room_id": { "type": "number", "description": "Room ID", "example": 7.576300889943182e+18 }, "room_id_str": { "type": "string", "description": "Room ID in string", "example": "7576300889943182000" } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiLiveCheck-alive", "tags": [ "Live" ], "parameters": [ { "in": "query", "name": "uniqueId", "schema": { "type": "string", "minLength": 1, "description": "Unique ID", "example": "soloz___" }, "required": true } ], "summary": "Check Alive", "description": "Check if the specified user is currently live on TikTok", "security": [ { "apiKeyAuth": [] } ] } }, "/api/music/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "musicInfo": { "type": "object", "properties": { "artist": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" } } }, "artists": { "type": "array", "items": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" } } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "stats": { "type": "object", "properties": { "videoCount": { "type": "number", "description": "Total number of videos using this music", "example": 737500 } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiMusicInfo", "tags": [ "Music" ], "parameters": [ { "in": "query", "name": "musicId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Music ID", "example": "7556815852168759313" }, "required": true } ], "summary": "Get Music Info", "description": "Get Music Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/music/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "30" }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiMusicPosts", "tags": [ "Music" ], "parameters": [ { "in": "query", "name": "musicId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Music ID", "example": "7556815852168759313" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0", "example": "0" }, "required": false } ], "summary": "Get Music Posts", "description": "Get Music Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/music/unlimited-sounds": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "total": { "type": "number", "description": "", "example": 84549 }, "music_list": { "type": "array", "items": { "type": "object", "properties": { "album": { "type": "string", "description": "", "example": "Funk It Up" }, "allow_offline_music_to_detail_page": { "type": "boolean", "description": "", "example": false }, "artists": { "type": "array", "items": { }, "description": "", "example": [] }, "audition_duration": { "type": "number", "description": "", "example": 0 }, "author": { "type": "string", "description": "", "example": "Official Sound Studio" }, "author_deleted": { "type": "boolean", "description": "", "example": false }, "binded_challenge_id": { "type": "number", "description": "", "example": 0 }, "can_be_stitched": { "type": "boolean", "description": "", "example": true }, "can_not_reuse": { "type": "boolean", "description": "", "example": false }, "collect_stat": { "type": "number", "description": "", "example": 0 }, "commercial_right_type": { "type": "number", "description": "", "example": 2 }, "cover_large": { "type": "object", "properties": { "height": { "type": "number", "description": "", "example": 720 }, "uri": { "type": "string", "description": "", "example": "tiktok-obj/default_clip_cover.png" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sg.tiktokcdn.com/aweme/720x720/tiktok-obj/default_clip_cover.png.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null }, "width": { "type": "number", "description": "", "example": 720 } } }, "cover_medium": { "type": "object", "properties": { "height": { "type": "number", "description": "", "example": 720 }, "uri": { "type": "string", "description": "", "example": "tiktok-obj/default_clip_cover.png" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sg.tiktokcdn.com/aweme/720x720/tiktok-obj/default_clip_cover.png.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null }, "width": { "type": "number", "description": "", "example": 720 } } }, "cover_thumb": { "type": "object", "properties": { "height": { "type": "number", "description": "", "example": 720 }, "uri": { "type": "string", "description": "", "example": "tiktok-obj/default_clip_cover.png" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sg.tiktokcdn.com/aweme/720x720/tiktok-obj/default_clip_cover.png.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null }, "width": { "type": "number", "description": "", "example": 720 } } }, "create_time": { "type": "number", "description": "", "example": 1563348824 }, "dmv_auto_show": { "type": "boolean", "description": "", "example": false }, "duration": { "type": "number", "description": "", "example": 33 }, "duration_high_precision": { "type": "object", "properties": { "audition_duration_precision": { "type": "number", "description": "", "example": 0 }, "duration_precision": { "type": "number", "description": "", "example": 33 }, "shoot_duration_precision": { "type": "number", "description": "", "example": 0 }, "video_duration_precision": { "type": "number", "description": "", "example": 0 } } }, "external_song_info": { "type": "array", "items": { }, "description": "", "example": [] }, "extra": { "type": "string", "description": "", "example": "{\"aed_music_dur\":33.77,\"amplitude_peak\":0.879364,\"beats\":{\"audio_effect_onset\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/7b0b68eb7ef145e1a82e09382b54ce12\",\"beats_tracker\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/1a7c30a1607743f58a0220440dff59e2\",\"energy_trace\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/13d51157fd80461696d905d2b4317dd2\",\"merged_beats\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/12e011929e674e85b307b5e0da78c960\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":0,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-15.890585,\"music_vid\":\"v10ad6990000bvuj9clgt18e4aei0kp0\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":1,\"schedule_search_time\":0}" }, "has_commerce_right": { "type": "boolean", "description": "", "example": false }, "id": { "type": "number", "description": "", "example": 6.714532073182334e+18 }, "id_str": { "type": "string", "description": "", "example": "6714532073182333697" }, "is_audio_url_with_cookie": { "type": "boolean", "description": "", "example": false }, "is_author_artist": { "type": "boolean", "description": "", "example": false }, "is_commerce_music": { "type": "boolean", "description": "", "example": true }, "is_matched_metadata": { "type": "boolean", "description": "", "example": false }, "is_original": { "type": "boolean", "description": "", "example": false }, "is_original_sound": { "type": "boolean", "description": "", "example": false }, "is_pgc": { "type": "boolean", "description": "", "example": true }, "is_play_music": { "type": "boolean", "description": "", "example": false }, "is_shooting_allow": { "type": "boolean", "description": "", "example": true }, "is_unlimited_music": { "type": "boolean", "description": "", "example": true }, "language": { "type": "string", "description": "", "example": "non_vocal" }, "log_extra": { "type": "string", "description": "", "example": "{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}" }, "lyric_short_position": { "type": "null", "description": "", "example": null }, "matched_song": { "type": "object", "properties": { "author": { "type": "string", "description": "", "example": "BCD Studio" }, "chorus_info": { "type": "object", "properties": { "duration_ms": { "type": "number", "description": "", "example": 16512 }, "start_ms": { "type": "number", "description": "", "example": 0 } } }, "cover_medium": { "type": "object", "properties": { "height": { "type": "number", "description": "", "example": 720 }, "uri": { "type": "string", "description": "", "example": "tiktok-obj/default_clip_cover.png" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sg.tiktokcdn.com/aweme/720x720/tiktok-obj/default_clip_cover.png.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null }, "width": { "type": "number", "description": "", "example": 720 } } }, "full_duration": { "type": "number", "description": "", "example": 33777 }, "h5_url": { "type": "string", "description": "", "example": "" }, "id": { "type": "string", "description": "", "example": "7085455230749378562" }, "performers": { "type": "null", "description": "", "example": null }, "title": { "type": "string", "description": "", "example": "Future" } } }, "meme_song_info": { "type": "object", "description": "", "example": { } }, "mid": { "type": "string", "description": "", "example": "6714532073182333697" }, "multi_bit_rate_play_info": { "type": "null", "description": "", "example": null }, "music_release_info": { "type": "object", "properties": { "group_release_date": { "type": "number", "description": "", "example": 0 }, "is_new_release_song": { "type": "boolean", "description": "", "example": false } } }, "mute_share": { "type": "boolean", "description": "", "example": false }, "offline_desc": { "type": "string", "description": "", "example": "" }, "owner_handle": { "type": "string", "description": "", "example": "" }, "owner_nickname": { "type": "string", "description": "", "example": "" }, "play_url": { "type": "object", "properties": { "height": { "type": "number", "description": "", "example": 720 }, "uri": { "type": "string", "description": "", "example": "tiktok-obj/default_clip_cover.png" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sg.tiktokcdn.com/aweme/720x720/tiktok-obj/default_clip_cover.png.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null }, "width": { "type": "number", "description": "", "example": 720 } } }, "position": { "type": "null", "description": "", "example": null }, "prevent_download": { "type": "boolean", "description": "", "example": false }, "preview_end_time": { "type": "number", "description": "", "example": 0 }, "preview_start_time": { "type": "number", "description": "", "example": 0 }, "recommend_status": { "type": "number", "description": "", "example": 100 }, "search_highlight": { "type": "null", "description": "", "example": null }, "shoot_duration": { "type": "number", "description": "", "example": 0 }, "source_platform": { "type": "number", "description": "", "example": 140 }, "status": { "type": "number", "description": "", "example": 1 }, "strong_beat_url": { "type": "object", "properties": { "height": { "type": "number", "description": "", "example": 720 }, "uri": { "type": "string", "description": "", "example": "tiktok-obj/default_clip_cover.png" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "https://p16-sg.tiktokcdn.com/aweme/720x720/tiktok-obj/default_clip_cover.png.jpeg" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "", "example": null }, "width": { "type": "number", "description": "", "example": 720 } } }, "style_value": { "type": "array", "items": { "type": "number" }, "description": "", "example": [151] }, "tag_list": { "type": "null", "description": "", "example": null }, "theme_value": { "type": "array", "items": { "type": "number" }, "description": "", "example": [2] }, "title": { "type": "string", "description": "", "example": "Future" }, "tt_to_dsp_song_infos": { "type": "null", "description": "", "example": null }, "uncert_artists": { "type": "null", "description": "", "example": null }, "user_count": { "type": "number", "description": "", "example": 3378392 }, "video_duration": { "type": "number", "description": "", "example": 0 } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiMusicUnlimited-sounds", "tags": [ "Music" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "pageSize", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 10, "description": "Number of items per page (maximum is 10)", "example": 10, "maximum": 10 } }, { "in": "query", "name": "orderBy", "schema": { "type": "string", "description": "\n Order By:\n - 1: Hot\n - 2: New\n ", "enum": [ "1", "2" ], "default": "1", "example": "1" } } ], "summary": "Get Music Unlimited Sounds", "description": "Get Music Unlimited Sounds", "security": [ { "apiKeyAuth": [] } ] } }, "/api/place/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "poiInfo": { "type": "object", "properties": { "poi": { "type": "object", "properties": { "address": { "type": "string", "description": "Full address of the place", "example": "California, United States" }, "allLevelGeoPoiInfo": { "type": "object", "description": "Hierarchical geographic Point of Interest (POI) information for all levels", "example": { } }, "category": { "type": "string", "description": "Category of the place", "example": "Places" }, "city": { "type": "string", "description": "City name where the place is located", "example": "" }, "cityCode": { "type": "string", "description": "Unique identifier code for the city", "example": "116023605" }, "country": { "type": "string", "description": "Country name where the place is located", "example": "" }, "countryCode": { "type": "string", "description": "Unique identifier code for the country", "example": "6252001" }, "fatherPoiId": { "type": "string", "description": "ID of the parent POI, if this place belongs to a larger area", "example": "" }, "fatherPoiName": { "type": "string", "description": "Name of the parent POI", "example": "" }, "id": { "type": "string", "description": "Place ID", "example": "22535865202704586" }, "indexEnabled": { "type": "boolean", "description": "Indicates whether this place is indexed and searchable", "example": true }, "isClaimed": { "type": "boolean", "description": "Indicates whether the place has been claimed by the owner", "example": false }, "isCollected": { "type": "boolean", "description": "", "example": false }, "name": { "type": "string", "description": "Name of the place", "example": "Hollywood" }, "phoneInfo": { "type": "object", "properties": { "exist": { "type": "boolean", "description": "Indicates whether phone information exists for the place", "example": false } } }, "pictureAlbum": { "type": "object", "properties": { "totalCount": { "type": "number", "description": "Total number of pictures in the place’s album", "example": 0 } } }, "poiDetailTags": { "type": "array", "items": { "type": "object", "properties": { "content": { "type": "string", "description": "Tag content describing the place", "example": "Places" }, "tagType": { "type": "number", "description": "Numeric code representing the type of the tag", "example": 5 } } } }, "province": { "type": "string", "description": "Province or state where the place is located", "example": "" }, "ttTypeCode": { "type": "string", "description": "Internal TikTok type code for the place", "example": "19a3a6" }, "ttTypeNameMedium": { "type": "string", "description": "Medium-level type name of the place", "example": "Places" }, "ttTypeNameSuper": { "type": "string", "description": "Top-level type name of the place", "example": "Place and Address" }, "ttTypeNameTiny": { "type": "string", "description": "Smallest-level type name of the place", "example": "Other Places" }, "type": { "type": "number", "description": "Numeric type indicator of the place", "example": 1 }, "typeCode": { "type": "string", "description": "Optional type code for additional classification of the place", "example": "" } } }, "stats": { "type": "object", "properties": { "videoCount": { "type": "number", "description": "Total number of videos associated with this place", "example": 319656 } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPlaceInfo", "tags": [ "Place" ], "parameters": [ { "in": "query", "name": "placeId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Place ID", "example": "22535865202704586" }, "required": true } ], "summary": "Get Place Info", "description": "Get Place Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/place/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "30" }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } }, "poi": { "type": "object", "properties": { "address": { "type": "string", "description": "Full address of the place", "example": "California, United States" }, "allLevelGeoPoiInfo": { "type": "object", "description": "Hierarchical geographic Point of Interest (POI) information for all levels", "example": { } }, "category": { "type": "string", "description": "Category of the place", "example": "Places" }, "city": { "type": "string", "description": "City name where the place is located", "example": "" }, "cityCode": { "type": "string", "description": "Unique identifier code for the city", "example": "116023605" }, "country": { "type": "string", "description": "Country name where the place is located", "example": "" }, "countryCode": { "type": "string", "description": "Unique identifier code for the country", "example": "6252001" }, "fatherPoiId": { "type": "string", "description": "ID of the parent POI, if this place belongs to a larger area", "example": "" }, "fatherPoiName": { "type": "string", "description": "Name of the parent POI", "example": "" }, "id": { "type": "string", "description": "Place ID", "example": "22535865202704586" }, "indexEnabled": { "type": "boolean", "description": "Indicates whether this place is indexed and searchable", "example": true }, "isClaimed": { "type": "boolean", "description": "Indicates whether the place has been claimed by the owner", "example": false }, "isCollected": { "type": "boolean", "description": "", "example": false }, "name": { "type": "string", "description": "Name of the place", "example": "Hollywood" }, "phoneInfo": { "type": "object", "properties": { "exist": { "type": "boolean", "description": "Indicates whether phone information exists for the place", "example": false } } }, "pictureAlbum": { "type": "object", "properties": { "totalCount": { "type": "number", "description": "Total number of pictures in the place’s album", "example": 0 } } }, "poiDetailTags": { "type": "array", "items": { "type": "object", "properties": { "content": { "type": "string", "description": "Tag content describing the place", "example": "Places" }, "tagType": { "type": "number", "description": "Numeric code representing the type of the tag", "example": 5 } } } }, "province": { "type": "string", "description": "Province or state where the place is located", "example": "" }, "ttTypeCode": { "type": "string", "description": "Internal TikTok type code for the place", "example": "19a3a6" }, "ttTypeNameMedium": { "type": "string", "description": "Medium-level type name of the place", "example": "Places" }, "ttTypeNameSuper": { "type": "string", "description": "Top-level type name of the place", "example": "Place and Address" }, "ttTypeNameTiny": { "type": "string", "description": "Smallest-level type name of the place", "example": "Other Places" }, "type": { "type": "number", "description": "Numeric type indicator of the place", "example": 1 }, "typeCode": { "type": "string", "description": "Optional type code for additional classification of the place", "example": "" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiPlacePosts", "tags": [ "Place" ], "parameters": [ { "in": "query", "name": "placeId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "", "example": "22535865202704586" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0", "example": "0" }, "required": false } ], "summary": "Get Place Posts", "description": "Get Place Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/effect/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "sticker_infos": { "type": "array", "items": { "type": "object", "properties": { "attributions": { "type": [ "string", "null" ], "description": "Attributions for the effect, if applicable", "example": null }, "children": { "type": "array", "items": { "type": "string" }, "description": "List of child effects derived from this effect", "example": [] }, "desc": { "type": "string", "description": "Description of the effect", "example": "" }, "effect_id": { "type": "string", "description": "Effect ID", "example": "321535" }, "effect_source": { "type": "number", "description": "Source type of the effect", "example": 0 }, "extra": { "type": "string", "description": "Additional metadata for the effect, stored as JSON string", "example": "{\"prop_block_story\":true,\"zstFileSize\":\"282781\",\"zstFileUri\":\"54635c330085ae4442197c03da11cd52\",\"zipMd5\":\"cf79b19bcfb3acbc4cbbe6663f822af0\"}" }, "icon_url": { "type": "object", "properties": { "uri": { "type": "string", "description": "Internal URI for the effect icon", "example": "cfaa5ce4a49351ceb195197df28a788b" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "List of URLs for the effect icon images", "example": [ "https://lf16-effectcdn-sg.tiktokcdn.com/obj/ies.fe.effect.alisg/cfaa5ce4a49351ceb195197df28a788b" ] }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix for constructing full icon URLs", "example": null } } }, "id": { "type": "string", "description": "Unique identifier of the effect (same as effect_id)", "example": "321535" }, "is_top_effect_designer": { "type": "boolean", "description": "Indicates whether the effect’s creator is a top effect designer", "example": false }, "linked_anchors": { "type": [ "string", "null" ], "description": "Linked anchors or references for the effect, if any", "example": null }, "name": { "type": "string", "description": "Name of the effect", "example": "Green Screen" }, "owner_id": { "type": "string", "description": "User ID of the effect’s creator", "example": "" }, "owner_nickname": { "type": "string", "description": "Nickname of the effect’s creator", "example": "Effect Assistant" }, "owner_verified_type": { "type": "number", "description": "Verification type of the effect’s creator", "example": 0 }, "publish_time": { "type": "number", "description": "Unix timestamp (ms) when the effect was published", "example": 1565699542000 }, "sec_uid": { "type": "string", "description": "secUid of the effect’s creator", "example": "" }, "tags": { "type": "array", "items": { "type": "string" }, "description": "Tags associated with the effect, used for filtering and categorization", "example": [ "canStack", "camera front", "gs_enable_tt_effect_page_filter" ] }, "user_count": { "type": "number", "description": "Total number of users who have used this effect", "example": 1022772250 }, "vv_count": { "type": "number", "description": "Total number of views generated by videos using this effect", "example": 221123177392 } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiEffectInfo", "tags": [ "Effect" ], "parameters": [ { "in": "query", "name": "effectId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Effect ID", "example": "321535" }, "required": true } ], "summary": "Get Effect Info", "description": "Get Effect Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/effect/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 30 }, "aweme_list": { "type": "array", "items": { "type": "object" } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiEffectPosts", "tags": [ "Effect" ], "parameters": [ { "in": "query", "name": "effectId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Effect ID", "example": "321535" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "example": 0 }, "required": false } ], "summary": "Get Effect Posts", "description": "Get Effect Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/search/general": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 12 }, "log_pb": { "type": "object", "properties": { "impr_id": { "type": "string", "description": "search_id to be used together with the cursor for pagination in subsequent requests to fetch more data", "example": "20251120012712816099520CDA04824F17" } } }, "data": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "number", "description": "Video", "example": 1 }, "item": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } }, { "type": "object", "properties": { "type": { "type": "number", "description": "Account", "example": 4 }, "user_list": { "type": "array", "items": { "type": "object", "properties": { "user_info": { "type": "object", "properties": { "uid": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "nickname": { "type": "string", "description": "Display name of the user", "example": "Taylor Swift" }, "signature": { "type": "string", "description": "User profile bio", "example": "This is pretty much just a cat account" }, "avatar_thumb": { "type": "object", "properties": { "uri": { "type": "string", "description": "Internal URI of the user avatar thumbnail", "example": "tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "List of URLs for the avatar thumbnail", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=532dfbd1&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1764226800&x-signature=uN3qdOWoiodw3SgcQmiEufsX4tk%3D", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=b29c771f&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1764226800&x-signature=SP8r9XFIkHLPpJxsClv88JlLMNE%3D" ] }, "width": { "type": "number", "description": "Width of the avatar thumbnail", "example": 720 }, "height": { "type": "number", "description": "Height of the avatar thumbnail", "example": 720 }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix for the avatar", "example": null } } }, "follower_count": { "type": "number", "description": "Number of followers the user has", "example": 33300000 }, "total_favorited": { "type": "number", "description": "Total number of likes the user has received", "example": 263939715 }, "custom_verify": { "type": "string", "description": "Verification label of the account", "example": "Verified account" }, "unique_id": { "type": "string", "description": "User uniqueId", "example": "taylorswift" }, "room_id": { "type": "number", "description": "Live room ID if the user is currently streaming", "example": 0 }, "enterprise_verify_reason": { "type": "string", "description": "", "example": "" }, "followers_detail": { "type": "null", "description": "", "example": null }, "platform_sync_info": { "type": "null", "description": "", "example": null }, "geofencing": { "type": "null", "description": "", "example": null }, "cover_url": { "type": "null", "description": "", "example": null }, "item_list": { "type": "null", "description": "", "example": null }, "type_label": { "type": "null", "description": "", "example": null }, "ad_cover_url": { "type": "null", "description": "", "example": null }, "relative_users": { "type": "null", "description": "", "example": null }, "cha_list": { "type": "null", "description": "", "example": null }, "sec_uid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "need_points": { "type": "null", "description": "", "example": null }, "homepage_bottom_toast": { "type": "null", "description": "", "example": null }, "can_set_geofencing": { "type": "null", "description": "", "example": null }, "white_cover_url": { "type": "null", "description": "", "example": null }, "user_tags": { "type": "null", "description": "", "example": null }, "bold_fields": { "type": "null", "description": "", "example": null }, "search_highlight": { "type": "null", "description": "", "example": null }, "mutual_relation_avatars": { "type": "null", "description": "", "example": null }, "room_id_str": { "type": "string", "description": "String representation of the live room ID", "example": "" }, "events": { "type": "null", "description": "", "example": null }, "advance_feature_item_order": { "type": "null", "description": "", "example": null }, "advanced_feature_info": { "type": "null", "description": "", "example": null }, "user_profile_guide": { "type": "null", "description": "", "example": null }, "shield_edit_field_info": { "type": "null", "description": "", "example": null }, "can_message_follow_status_list": { "type": "null", "description": "", "example": null }, "account_labels": { "type": "null", "description": "", "example": null } } }, "position": { "type": "null", "description": "", "example": null }, "uniqid_position": { "type": "null", "description": "", "example": null }, "effects": { "type": "null", "description": "", "example": null }, "musics": { "type": "null", "description": "", "example": null }, "items": { "type": "null", "description": "", "example": null }, "mix_list": { "type": "null", "description": "", "example": null }, "challenges": { "type": "null", "description": "", "example": null } } } } } } ] } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiSearchGeneral", "tags": [ "Search" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "minLength": 1, "description": "Search keyword", "example": "cat" }, "required": true }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request. In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "example": 0 }, "required": false }, { "in": "query", "name": "search_id", "schema": { "type": "string", "description": "search_id parameter is used for pagination. In the first request, the default value of the search_id is 0. For subsequent requests, the value of the cursor will be taken from the response of the previous request (from: **log_pb.impr_id**). In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "default": "0", "example": "0" }, "required": false } ], "summary": "Search General", "description": "Search General (Top)", "security": [ { "apiKeyAuth": [] } ] } }, "/api/search/video": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 12 }, "log_pb": { "type": "object", "properties": { "impr_id": { "type": "string", "description": "search_id to be used together with the cursor for pagination in subsequent requests to fetch more data", "example": "20251120012712816099520CDA04824F17" } } }, "item_list": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiSearchVideo", "tags": [ "Search" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "minLength": 1, "description": "Search keyword", "example": "cat" }, "required": true }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request. In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "example": 0 }, "required": false }, { "in": "query", "name": "search_id", "schema": { "type": "string", "description": "search_id parameter is used for pagination. In the first request, the default value of the search_id is 0. For subsequent requests, the value of the cursor will be taken from the response of the previous request (from: **log_pb.impr_id**). In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "default": "0", "example": "0" }, "required": false } ], "summary": "Search Video", "description": "Search Video", "security": [ { "apiKeyAuth": [] } ] } }, "/api/search/account": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 12 }, "log_pb": { "type": "object", "properties": { "impr_id": { "type": "string", "description": "search_id to be used together with the cursor for pagination in subsequent requests to fetch more data", "example": "20251120012712816099520CDA04824F17" } } }, "user_list": { "type": "array", "items": { "type": "object", "properties": { "user_info": { "type": "object", "properties": { "uid": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "nickname": { "type": "string", "description": "Display name of the user", "example": "Taylor Swift" }, "signature": { "type": "string", "description": "User profile bio", "example": "This is pretty much just a cat account" }, "avatar_thumb": { "type": "object", "properties": { "uri": { "type": "string", "description": "Internal URI of the user avatar thumbnail", "example": "tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba" }, "url_list": { "type": "array", "items": { "type": "string" }, "description": "List of URLs for the avatar thumbnail", "example": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=532dfbd1&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1764226800&x-signature=uN3qdOWoiodw3SgcQmiEufsX4tk%3D", "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=b29c771f&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1764226800&x-signature=SP8r9XFIkHLPpJxsClv88JlLMNE%3D" ] }, "width": { "type": "number", "description": "Width of the avatar thumbnail", "example": 720 }, "height": { "type": "number", "description": "Height of the avatar thumbnail", "example": 720 }, "url_prefix": { "type": [ "string", "null" ], "description": "Optional URL prefix for the avatar", "example": null } } }, "follower_count": { "type": "number", "description": "Number of followers the user has", "example": 33300000 }, "total_favorited": { "type": "number", "description": "Total number of likes the user has received", "example": 263939715 }, "custom_verify": { "type": "string", "description": "Verification label of the account", "example": "Verified account" }, "unique_id": { "type": "string", "description": "User uniqueId", "example": "taylorswift" }, "room_id": { "type": "number", "description": "Live room ID if the user is currently streaming", "example": 0 }, "enterprise_verify_reason": { "type": "string", "description": "", "example": "" }, "followers_detail": { "type": "null", "description": "", "example": null }, "platform_sync_info": { "type": "null", "description": "", "example": null }, "geofencing": { "type": "null", "description": "", "example": null }, "cover_url": { "type": "null", "description": "", "example": null }, "item_list": { "type": "null", "description": "", "example": null }, "type_label": { "type": "null", "description": "", "example": null }, "ad_cover_url": { "type": "null", "description": "", "example": null }, "relative_users": { "type": "null", "description": "", "example": null }, "cha_list": { "type": "null", "description": "", "example": null }, "sec_uid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "need_points": { "type": "null", "description": "", "example": null }, "homepage_bottom_toast": { "type": "null", "description": "", "example": null }, "can_set_geofencing": { "type": "null", "description": "", "example": null }, "white_cover_url": { "type": "null", "description": "", "example": null }, "user_tags": { "type": "null", "description": "", "example": null }, "bold_fields": { "type": "null", "description": "", "example": null }, "search_highlight": { "type": "null", "description": "", "example": null }, "mutual_relation_avatars": { "type": "null", "description": "", "example": null }, "room_id_str": { "type": "string", "description": "String representation of the live room ID", "example": "" }, "events": { "type": "null", "description": "", "example": null }, "advance_feature_item_order": { "type": "null", "description": "", "example": null }, "advanced_feature_info": { "type": "null", "description": "", "example": null }, "user_profile_guide": { "type": "null", "description": "", "example": null }, "shield_edit_field_info": { "type": "null", "description": "", "example": null }, "can_message_follow_status_list": { "type": "null", "description": "", "example": null }, "account_labels": { "type": "null", "description": "", "example": null } } }, "position": { "type": "null", "description": "", "example": null }, "uniqid_position": { "type": "null", "description": "", "example": null }, "effects": { "type": "null", "description": "", "example": null }, "musics": { "type": "null", "description": "", "example": null }, "items": { "type": "null", "description": "", "example": null }, "mix_list": { "type": "null", "description": "", "example": null }, "challenges": { "type": "null", "description": "", "example": null } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiSearchAccount", "tags": [ "Search" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "minLength": 1, "description": "Search keyword", "example": "taylor" }, "required": true }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request. In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "example": 0 }, "required": false }, { "in": "query", "name": "search_id", "schema": { "type": "string", "description": "search_id parameter is used for pagination. In the first request, the default value of the search_id is 0. For subsequent requests, the value of the cursor will be taken from the response of the previous request (from: **log_pb.impr_id**). In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "default": "0", "example": "0" }, "required": false } ], "summary": "Search Account", "description": "Search Account", "security": [ { "apiKeyAuth": [] } ] } }, "/api/search/live": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "number", "description": "Indicates whether there are more data available to fetch", "example": 1 }, "cursor": { "type": "number", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": 12 }, "log_pb": { "type": "object", "properties": { "impr_id": { "type": "string", "description": "search_id to be used together with the cursor for pagination in subsequent requests to fetch more data", "example": "20251120012712816099520CDA04824F17" } } }, "data": { "type": "array", "items": { "type": "object", "properties": { "live_info": { "type": "object", "properties": { "raw_data": { "type": "string", "description": "Raw JSON string containing full live metadata returned directly from TikTok", "example": "{\"id\":7574451318585133837,\"id_str\":\"7574451318585133837\",\"status\":2,\"owner_user_id\":7539735302052856887,\"title\":\"Beautiful inside and out 🥰\",\"user_count\":922,\"client_version\":410600,\"cover\":{\"url_list\":[\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=1e2df452&x-expires=1763744400&x-signature=zN7%2BLq9PJew7MgbyyccZBrCr5d4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\",\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=94bb3d40&x-expires=1763744400&x-signature=qFydRLXufsPvn6orXj3xAIFMjB8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\"],\"uri\":\"720x720/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795\"},\"stream_url\":{\"extra\":{},\"rtmp_pull_url\":\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_or4.flv?expire=1764783191&session_id=148-20251120013310179171A167DBB277A5DB&sign=9ac2fb383db6ec4fedf3223af880fa6a\",\"flv_pull_url\":{\"HD1\":\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_hd.flv?expire=1764783191&sign=f5d59e10ccf6dd4c4553550bc10e4f6d\",\"SD1\":\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_ld.flv?expire=1764783191&sign=62435ee17396f045f30828aab0fc999f\",\"SD2\":\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_sd.flv?expire=1764783191&sign=27a5ab599943375c12b0b64ca1c6b7f8\"},\"candidate_resolution\":[\"SD1\",\"SD2\",\"HD1\"],\"flv_pull_url_params\":{\"HD1\":\"{\\\"v_rtbitrate_vpaas_timestamp\\\":1763573591115,\\\"v_rtbitrate\\\":1037119.9999999999,\\\"v_rtbitrate_pct\\\":1052780,\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1000000,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_std\\\":16810,\\\"VCodec\\\":\\\"h264\\\",\\\"v_rtbitrate_timestamp\\\":1763573564284,\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\",\"SD1\":\"{\\\"cdn_name\\\":\\\"fcdn\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"gop\\\":0,\\\"v_rtbitrate_vpaas_timestamp\\\":1763573591115,\\\"v_rtbitrate_pct\\\":646600,\\\"v_rtbitrate_timestamp\\\":1763573353719,\\\"stream_suffix\\\":\\\"ld\\\",\\\"v_rtbitrate\\\":632480,\\\"v_rtpsnr\\\":0,\\\"vbitrate\\\":500000,\\\"resolution\\\":\\\"480x853\\\",\\\"v_rtbitrate_std\\\":12170}\",\"SD2\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"v_rtbitrate_vpaas_timestamp\\\":1763573591115,\\\"resolution\\\":\\\"480x853\\\",\\\"v_rtbitrate_pct\\\":984640,\\\"vbitrate\\\":800000,\\\"v_rtpsnr\\\":0,\\\"stream_suffix\\\":\\\"sd\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate\\\":945630,\\\"v_rtbitrate_timestamp\\\":1763573571100,\\\"v_rtbitrate_std\\\":23880,\\\"gop\\\":0}\"},\"live_core_sdk_data\":{\"pull_data\":{\"stream_data\":\"{\\\"common\\\":{\\\"session_id\\\":\\\"148-20251120013310179171A167DBB277A5DB\\\",\\\"rule_ids\\\":\\\"{\\\\\\\"ab_version_trace\\\\\\\":null,\\\\\\\"sched\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"result\\\\\\\\\\\\\\\":{\\\\\\\\\\\\\\\"hit\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"default\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"cdn\\\\\\\\\\\\\\\":2047}}\\\\\\\"}\\\",\\\"user_count\\\":859,\\\"peer_anchor_level\\\":16},\\\"data\\\":{\\\"origin\\\":{\\\"main\\\":{\\\"flv\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_or4.flv?expire=1764783191\\&sign=9ac2fb383db6ec4fedf3223af880fa6a\\\",\\\"hls\\\":\\\"https://pull-hls-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_or4/index.m3u8?expire=1764783191\\&sign=1cad6d30ae70a4bd97d5d6270e8462e0\\\",\\\"cmaf\\\":\\\"https://pull-cmaf-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_or4/index.mpd?expire=1764783191\\&sign=9b430d20f55020f389fd0d26c785883b\\\",\\\"dash\\\":\\\"\\\",\\\"lls\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_or4.sdp?expire=1764783191\\&sign=096a090128e8e3a17c0eb8f48c7890cb\\\",\\\"tsl\\\":\\\"\\\",\\\"tile\\\":\\\"\\\",\\\"rtc\\\":\\\"\\\",\\\"sdk_params\\\":\\\"{\\\\\\\"vbitrate\\\\\\\":1000000,\\\\\\\"stream_suffix\\\\\\\":\\\\\\\"or4\\\\\\\",\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"v_rtbitrate\\\\\\\":2687100,\\\\\\\"v_rtpsnr\\\\\\\":0,\\\\\\\"v_rtbitrate_pct\\\\\\\":2722930,\\\\\\\"v_rtbitrate_timestamp\\\\\\\":1763573564041,\\\\\\\"v_rtbitrate_vpaas_timestamp\\\\\\\":1763573591115,\\\\\\\"VCodec\\\\\\\":\\\\\\\"h264\\\\\\\",\\\\\\\"v_rtbitrate_std\\\\\\\":29700,\\\\\\\"resolution\\\\\\\":\\\\\\\"720x1280\\\\\\\",\\\\\\\"gop\\\\\\\":4}\\\"}},\\\"sd\\\":{\\\"main\\\":{\\\"flv\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_sd.flv?expire=1764783191\\&sign=27a5ab599943375c12b0b64ca1c6b7f8\\\",\\\"hls\\\":\\\"https://pull-hls-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_sd/index.m3u8?expire=1764783191\\&sign=aa5029e105679f7e78efacec019c0018\\\",\\\"cmaf\\\":\\\"https://pull-cmaf-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_sd/index.mpd?expire=1764783191\\&sign=68607b68fd3e14e635575ac91d50a054\\\",\\\"dash\\\":\\\"\\\",\\\"lls\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_sd.sdp?expire=1764783191\\&sign=189ee6b209b72d6b66da3f3ce7ec48aa\\\",\\\"tsl\\\":\\\"\\\",\\\"tile\\\":\\\"\\\",\\\"rtc\\\":\\\"\\\",\\\"sdk_params\\\":\\\"{\\\\\\\"VCodec\\\\\\\":\\\\\\\"h264\\\\\\\",\\\\\\\"v_rtbitrate_vpaas_timestamp\\\\\\\":1763573591115,\\\\\\\"resolution\\\\\\\":\\\\\\\"480x853\\\\\\\",\\\\\\\"v_rtbitrate_pct\\\\\\\":984640,\\\\\\\"vbitrate\\\\\\\":800000,\\\\\\\"v_rtpsnr\\\\\\\":0,\\\\\\\"stream_suffix\\\\\\\":\\\\\\\"sd\\\\\\\",\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"v_rtbitrate\\\\\\\":945630,\\\\\\\"v_rtbitrate_timestamp\\\\\\\":1763573571100,\\\\\\\"v_rtbitrate_std\\\\\\\":23880,\\\\\\\"gop\\\\\\\":0}\\\"}},\\\"ld\\\":{\\\"main\\\":{\\\"flv\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_ld.flv?expire=1764783191\\&sign=62435ee17396f045f30828aab0fc999f\\\",\\\"hls\\\":\\\"https://pull-hls-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_ld/index.m3u8?expire=1764783191\\&sign=05c7e5daa85846c1961ce822b3a029af\\\",\\\"cmaf\\\":\\\"https://pull-cmaf-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_ld/index.mpd?expire=1764783191\\&sign=dff5d7b275132c8eeabf31607d44351a\\\",\\\"dash\\\":\\\"\\\",\\\"lls\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_ld.sdp?expire=1764783191\\&sign=9e1d5820b08fdc78fa383a3e2c94f72f\\\",\\\"tsl\\\":\\\"\\\",\\\"tile\\\":\\\"\\\",\\\"rtc\\\":\\\"\\\",\\\"sdk_params\\\":\\\"{\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"VCodec\\\\\\\":\\\\\\\"h264\\\\\\\",\\\\\\\"gop\\\\\\\":0,\\\\\\\"v_rtbitrate_vpaas_timestamp\\\\\\\":1763573591115,\\\\\\\"v_rtbitrate_pct\\\\\\\":646600,\\\\\\\"v_rtbitrate_timestamp\\\\\\\":1763573353719,\\\\\\\"stream_suffix\\\\\\\":\\\\\\\"ld\\\\\\\",\\\\\\\"v_rtbitrate\\\\\\\":632480,\\\\\\\"v_rtpsnr\\\\\\\":0,\\\\\\\"vbitrate\\\\\\\":500000,\\\\\\\"resolution\\\\\\\":\\\\\\\"480x853\\\\\\\",\\\\\\\"v_rtbitrate_std\\\\\\\":12170}\\\"}},\\\"hd\\\":{\\\"main\\\":{\\\"flv\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_hd.flv?expire=1764783191\\&sign=f5d59e10ccf6dd4c4553550bc10e4f6d\\\",\\\"hls\\\":\\\"https://pull-hls-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_hd/index.m3u8?expire=1764783191\\&sign=78f139cea9bf982b9b40a885fc9fb46a\\\",\\\"cmaf\\\":\\\"https://pull-cmaf-f16-tt01.tiktokcdn.com/stage/stream-3577115322732250032_hd/index.mpd?expire=1764783191\\&sign=59a897cf282a8058f1f5086d4f3ac71a\\\",\\\"dash\\\":\\\"\\\",\\\"lls\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032_hd.sdp?expire=1764783191\\&sign=e69c758ab9b78ce6d78a550475455452\\\",\\\"tsl\\\":\\\"\\\",\\\"tile\\\":\\\"\\\",\\\"rtc\\\":\\\"\\\",\\\"sdk_params\\\":\\\"{\\\\\\\"v_rtbitrate_vpaas_timestamp\\\\\\\":1763573591115,\\\\\\\"v_rtbitrate\\\\\\\":1037119.9999999999,\\\\\\\"v_rtbitrate_pct\\\\\\\":1052780,\\\\\\\"stream_suffix\\\\\\\":\\\\\\\"hd\\\\\\\",\\\\\\\"vbitrate\\\\\\\":1000000,\\\\\\\"v_rtpsnr\\\\\\\":0,\\\\\\\"v_rtbitrate_std\\\\\\\":16810,\\\\\\\"VCodec\\\\\\\":\\\\\\\"h264\\\\\\\",\\\\\\\"v_rtbitrate_timestamp\\\\\\\":1763573564284,\\\\\\\"resolution\\\\\\\":\\\\\\\"720x1280\\\\\\\",\\\\\\\"gop\\\\\\\":4,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\"}\\\"}},\\\"ao\\\":{\\\"main\\\":{\\\"flv\\\":\\\"https://pull-f5-tt01.tiktokcdn.com/stage/stream-3577115322732250032.flv?expire=1764783191\\&sign=9574eba45b4b1d05d3cb39700138f38b\\&only_audio=1\\\",\\\"hls\\\":\\\"\\\",\\\"cmaf\\\":\\\"\\\",\\\"dash\\\":\\\"\\\",\\\"lls\\\":\\\"\\\",\\\"tsl\\\":\\\"\\\",\\\"tile\\\":\\\"\\\",\\\"rtc\\\":\\\"\\\",\\\"sdk_params\\\":\\\"{\\\\\\\"VCodec\\\\\\\":\\\\\\\"h264\\\\\\\",\\\\\\\"vbitrate\\\\\\\":0,\\\\\\\"resolution\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"gop\\\\\\\":4,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\"}\\\"}}}}\",\"options\":{\"default_quality\":{\"name\":\"720p\",\"sdk_key\":\"hd\"},\"default_preview_quality\":{}}},\"push_data\":{}}},\"link_mic\":{\"channel_info\":{},\"battle_settings\":{}},\"stats\":{\"total_user\":93626,\"user_count_composition\":{},\"enter_count\":93626,\"share_count\":190,\"comment_count\":1796},\"living_room_attrs\":{},\"owner\":{\"id\":7539735302052856887,\"nickname\":\"Cute Cats\",\"bio_description\":\"EDT 07:00am ~ 14:00pm babe live time. Looking forward to your joining🎶💕\",\"avatar_thumb\":{\"url_list\":[\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=d3ec3f6f&x-expires=1763744400&x-signature=ZTxNp38Kbs5%2FSgACW9btyYIrHCw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\",\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=c7f0ffbc&x-expires=1763744400&x-signature=GdUJhJRto4MxmyQGbbgU0yKFE5A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\"],\"uri\":\"100x100/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795\"},\"avatar_medium\":{\"url_list\":[\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=1e2df452&x-expires=1763744400&x-signature=zN7%2BLq9PJew7MgbyyccZBrCr5d4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\",\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=94bb3d40&x-expires=1763744400&x-signature=qFydRLXufsPvn6orXj3xAIFMjB8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\"],\"uri\":\"720x720/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795\"},\"avatar_large\":{\"url_list\":[\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=4106ba99&x-expires=1763744400&x-signature=5%2FX6nqCSh9hkxmhiQ7%2B1b8TyHsM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\",\"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=4d53edf4&x-expires=1763744400&x-signature=Ygc5pw9q5w3ymEabbEWHc%2FxZ8vo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my2\"],\"uri\":\"1080x1080/tos-maliva-avt-0068/f8df60586b929672bc0024c0983bf795\"},\"status\":1,\"modify_time\":1763564483,\"follow_info\":{\"following_count\":781,\"follower_count\":75096},\"pay_grade\":{},\"user_attr\":{},\"own_room\":{\"room_ids\":[7574451318585133837],\"room_ids_str\":[\"7574451318585133837\"]},\"link_mic_stats\":2,\"display_id\":\"cutecats_008\",\"sec_uid\":\"MS4wLjABAAAAA6Qrmqi_dHdqboz9A11kCcZNwQnOyChOSq9m932XynhIX7nbb1DXfjFza9-51GmE\",\"mint_type_label\":[7047027142626691074],\"id_str\":\"7539735302052856887\"},\"start_time\":1763564486,\"room_auth\":{\"Landscape\":2,\"anchor_level_permission\":{}},\"like_count\":114475,\"stream_url_filtered_info\":{},\"social_interaction\":{},\"game_tag\":[{}],\"room_auth_message\":{},\"age_restricted\":{},\"multi_stream_url\":{\"extra\":{\"super_resolution\":{}},\"live_core_sdk_data\":{\"pull_data\":{\"options\":{\"default_quality\":{},\"default_preview_quality\":{}}},\"push_data\":{}}},\"cover_type\":1,\"sub_tag\":1,\"stream_snapshot\":{\"uri\":\"tos-alisg-i-6sfwe43m1g-sg/5e21e37d4bb54acca1094e02e7a5705c.jpeg\",\"urls\":[\"https://p16-sign-sg.tiktokcdn.com/tos-alisg-i-6sfwe43m1g-sg/5e21e37d4bb54acca1094e02e7a5705c.jpeg~tplv-tiktokx-origin.image?dr=14582&refresh_token=8d20ce88&x-expires=1763593200&x-signature=no0gu8r1%2B%2FtIwn1a5c9BusWXed8%3D&t=4d5b0474&ps=13740610&shp=97fb53a0&shcp=2de197d8&idc=my2\",\"https://p16-sign-sg.tiktokcdn.com/tos-alisg-i-6sfwe43m1g-sg/5e21e37d4bb54acca1094e02e7a5705c.jpeg~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=2aef9ae5&x-expires=1763593200&x-signature=nSp8MNu8iCGCnepRVR%2FVyyRq6aI%3D&t=4d5b0474&ps=13740610&shp=97fb53a0&shcp=2de197d8&idc=my2\"],\"height\":1280,\"width\":720,\"face_center_x\":317,\"face_center_y\":306}}" }, "room_info": { "type": "object", "properties": { "has_commerce_goods": { "type": "boolean", "description": "Indicates whether the live room has commerce goods enabled", "example": false }, "is_battle": { "type": "boolean", "description": "Indicates whether the live is currently in battle mode", "example": false } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiSearchLive", "tags": [ "Search" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "minLength": 1, "description": "Search keyword", "example": "cat" }, "required": true }, { "in": "query", "name": "cursor", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 0, "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request. In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "example": 0 }, "required": false }, { "in": "query", "name": "search_id", "schema": { "type": "string", "description": "search_id parameter is used for pagination. In the first request, the default value of the search_id is 0. For subsequent requests, the value of the cursor will be taken from the response of the previous request (from: **log_pb.impr_id**). In the Search Endpoints, both cursor and search_id need to be provided when pagination is used", "default": "0", "example": "0" }, "required": false } ], "summary": "Search Live", "description": "Search Live", "security": [ { "apiKeyAuth": [] } ] } }, "/api/search/others-searched-for": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "word": { "type": "string", "description": "Suggested search keyword returned based on the keyword query", "example": "tiktok viral cats" }, "group_id": { "type": "string", "description": "Identifier for the keyword suggestion group", "example": "5581626159306233377" } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiSearchOthers-searched-for", "tags": [ "Search" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "minLength": 1, "description": "Search keyword", "example": "cat" }, "required": true } ], "summary": "Get Suggest Search Keyword", "description": "Get Suggest Search Keyword", "security": [ { "apiKeyAuth": [] } ] } }, "/api/download/video": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "play": { "type": "string", "description": "Download Video URL (without watermark)", "example": "https://v16-coin.tiktokcdn.com/d2751cc018586a1b2e949b9be2b95588/69246660/video/tos/maliva/tos-maliva-ve-0068c799-us/oIBCEAlvdiDkwVjVcPaCP6sCTOEQBi4IlyRBA/?a=0&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2300&bt=1150&cs=0&ds=6&ft=-gnpiFvYwQQIUxtdKSNl7Er5SfqmaKPXtq_o36xyqF_4&mime_type=video_mp4&qs=0&rc=aDNpOzlkZWk0NTk0ODU8NEBpajdkM3Q5cjh2NjMzaTczNEAzLzRiMGBjX2MxMzEuMl8xYSMtX3JwMmQ0MmVhLS1kMTJzcw%3D%3D&vvpl=1&l=2025112416060770716282059C6E05C0BB&btag=e000b8000" }, "play_watermark": { "type": "string", "description": "Download Video URL (with watermark)", "example": "https://v16-coin.tiktokcdn.com/0f18254968e15ff0eaa1f01b5d39ec90/69246660/video/tos/maliva/tos-maliva-ve-0068c799-us/oYH4VQUIDlsK8BhIAEfXAegxLFwHEoEEl1CRkH/?a=0&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2352&bt=1176&cs=0&ds=3&ft=-gnpiFvYwQQIUxtdKSNl7Er5SfqmaKPXtq_o36xyqF_4&mime_type=video_mp4&qs=0&rc=Ojk4M2k0Ozo5ZDg2ZjdkZEBpajdkM3Q5cjh2NjMzaTczNEBjL2I2MTAuNV8xYi8xLS5gYSMtX3JwMmQ0MmVhLS1kMTJzcw%3D%3D&vvpl=1&l=2025112416060770716282059C6E05C0BB&btag=e000b8000" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiDownloadVideo", "tags": [ "Download" ], "parameters": [ { "in": "query", "name": "url", "schema": { "type": "string", "format": "uri", "description": "Video URL. For example: https://www.tiktok.com/@taylorswift/video/7558098574555254046", "example": "https://www.tiktok.com/@taylorswift/video/7558098574555254046" }, "required": true } ], "summary": "Download Video", "description": "Download Video", "security": [ { "apiKeyAuth": [] } ] } }, "/api/download/user/video": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "itemList": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Video ID", "example": "7558098574555254046" }, "desc": { "type": "string", "description": "Caption of the video", "example": "Pledge allegiance to your 👐 your 🏈 your viiiiiiiibes" }, "play": { "type": "string", "description": "Downloadable video URL (without watermark)", "example": "https://v16e.tiktokcdn.com/45d0ed2b831d82765153a0bf773c0642/69b63d1f/video/tos/maliva/tos-maliva-ve-0068c799-us/oIDknVfUIBL4lQE3ufRHEd1EmKlC8AIHgwADFo/?a=1340&bti=M0BzbGRxbGRoamRobDFybndmKTc6OWYucCNtXGxxZG9kK3FpaHFmOmQ0NDA6&&bt=893&ft=arF-Lqq3mbuPD12zPV.s3wUWtwalaeF~O5&mime_type=video_mp4&rc=Ojk4N2UzZGc5OjQ6ODdnZUBpajdkM3Q5cjh2NjMzaTczNEAvYS9jLjUwXjYxYjNhMzUvYSMtX3JwMmQ0MmVhLS1kMTJzcw%3D%3D&vvpl=1&l=20260314130103C551A75BACBBF42A59CB&btag=e000b8000" }, "images": { "type": "array", "items": { "type": "string" }, "description": "An array of image URLs when the video is a slide-based post", "example": [] }, "cover": { "type": "string", "description": "Video thumbnail image URL", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMBVk7RErrCPtlrI5DiiyJja6lI6P4OABBADw~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg?dr=16276&refresh_token=0c57284e&x-expires=1773550800&x-signature=7jXPQGUIAfpmvhqtZxAN9joqWGw%3D&t=5872c671&ps=933b5bde&shp=d05b14bd&shcp=ede7c6fc&idc=my2&biz_tag=tt_video&s=PUBLISH&sc=cover" }, "stats": { "type": "object", "properties": { "collect_count": { "type": "number", "description": "Number of times the video has been added to favorites", "example": 276831 }, "comment_count": { "type": "number", "description": "Total number of comments on the video", "example": 50721 }, "digg_count": { "type": "number", "description": "Total number of likes the video has received", "example": 5728783 }, "download_count": { "type": "number", "description": "Number of times the video has been downloaded", "example": 50285 }, "forward_count": { "type": "number", "description": "Number of times the video has been forwarded internally", "example": 0 }, "play_count": { "type": "number", "description": "Total number of times the video has been played", "example": 74219538 }, "repost_count": { "type": "number", "description": "Number of times the video has been reposted by users", "example": 475308 }, "share_count": { "type": "number", "description": "Number of times the video has been shared", "example": 154490 } } }, "create_time": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1759756985 } } } }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "minCursor": { "type": "number", "description": "minCursor parameter is used for pagination in the next request", "example": 1770959608000 }, "maxCursor": { "type": "number", "description": "maxCursor parameter is used for pagination in the next request", "example": 1759151497000 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiDownloadUserVideo", "tags": [ "Download" ], "parameters": [ { "in": "query", "name": "secUid", "schema": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "required": true }, { "in": "query", "name": "minCursor", "schema": { "type": "integer", "default": 0, "description": "minCursor parameter is used for pagination. In the first request, the default value of minCursor is 0. For subsequent requests, the value of minCursor will be taken from the response of the previous request. Both minCursor and maxCursor must be provided to paginate in the next request.", "example": 0 }, "required": false }, { "in": "query", "name": "maxCursor", "schema": { "type": "integer", "default": 0, "description": "maxCursor parameter is used for pagination. In the first request, the default value of maxCursor is 0. For subsequent requests, the value of maxCursor will be taken from the response of the previous request. Both minCursor and maxCursor must be provided to paginate in the next request.", "example": 0 }, "required": false } ], "summary": "Download All User Videos", "description": "Download All User Videos", "security": [ { "apiKeyAuth": [] } ] } }, "/api/download/music": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "play": { "type": "string", "description": "Download Music URL", "example": "https://sf16-ies-music-va.tiktokcdn.com/obj/tos-useast2a-ve-2774/oMoOQfKtCDE1Mg7qWVyBfFF1RBQXZYxKZ13Bhd" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiDownloadMusic", "tags": [ "Download" ], "parameters": [ { "in": "query", "name": "url", "schema": { "type": "string", "format": "uri", "description": "Video URL. For example: https://www.tiktok.com/@taylorswift/video/7558098574555254046", "example": "https://www.tiktok.com/@taylorswift/video/7558098574555254046" }, "required": true } ], "summary": "Download Music", "description": "Download Music", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/ads": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "materials": { "type": "array", "items": { "type": "object", "properties": { "ad_title": { "type": "string", "description": "", "example": "Save 25% at Target" }, "brand_name": { "type": "string", "description": "", "example": "HotWheelsLetsRace" }, "cost": { "type": "number", "description": "", "example": 1 }, "ctr": { "type": "number", "description": "", "example": 0.01 }, "favorite": { "type": "boolean", "description": "", "example": false }, "id": { "type": "string", "description": "", "example": "7574848560483926024" }, "industry_key": { "type": "string", "description": "", "example": "label_30102000000" }, "is_search": { "type": "boolean", "description": "", "example": true }, "like": { "type": "number", "description": "", "example": 154 }, "objective_key": { "type": "string", "description": "", "example": "campaign_objective_traffic" }, "video_info": { "type": "object", "properties": { "vid": { "type": "string", "description": "", "example": "v10033g50000d4fk9ovog65ppa0pi800" }, "duration": { "type": "number", "description": "", "example": 15.034 }, "cover": { "type": "string", "description": "", "example": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8KC0QYjfzpAAyHRQ4EtBFHDNBPDlgTQMIfQyQ~tplv-noop.image?dr=18692&refresh_token=ce06c89b&x-expires=1765827974&x-signature=9M68jwl7ZTSjpRAJf2CnvoUxBpM%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my" }, "video_url": { "type": "object", "properties": { "720p": { "type": "string", "description": "", "example": "https://v16m-default.tiktokcdn.com/8b4cc8c593174434cd367fd6d9582ada/69405cc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/okqGXQ0MAhRCJ0nW8XRbDAAlgxqefUR3NB3aeg/?a=0&bti=NTU4QDM1NGA%3D&ch=0&cr=0&dr=0&lr=tiktok_business&cd=0%7C0%7C1%7C0&cv=1&br=1570&bt=785&cs=0&ds=3&ft=cApXJCz7ThWHrs0-1GZmo0P&mime_type=video_mp4&qs=0&rc=ZDs2aDs6N2loZThlPDU7O0BpanI8Nm45cjM5NTMzODYzNEBiLjBhXzI1XjUxNi9jMF9hYSNiZ3BrMmQ0cWhhLS1kMC1zcw%3D%3D&vvpl=1&l=20251215210804481E21104311144D334E&btag=e00088000" } } }, "width": { "type": "number", "description": "", "example": 576 }, "height": { "type": "number", "description": "", "example": 1024 } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingAds", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 30, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n - 180: Last 180 days\n ", "enum": [7, 30, 180], "example": 30 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "example": "US" } }, { "in": "query", "name": "order_by", "schema": { "type": "string", "description": "\n Order by:\n - impression: Reach\n - ctr: CTR\n - like: Like\n - cvr: CRV\n - play_6s_rate: 6s view rate\n - play_2s_rate: 2s view rate\n ", "enum": [ "impression", "ctr", "like", "cvr", "play_6s_rate", "play_2s_rate" ] } }, { "in": "query", "name": "like", "schema": { "type": "string", "description": "\n Likes:\n - 1: Top 1~20%\n - 2: Top 21~40%\n - 3: Top 41~60%\n - 4: Top 61~80%\n - 5: Top 81~100%\n ", "enum": [ "1", "2", "3", "4", "5" ] } }, { "in": "query", "name": "ad_format", "schema": { "type": "string", "description": "\n Ad Format:\n - 1: Spark Ads\n - 2: Non-spark Ads\n ", "enum": [ "1", "2" ] } }, { "in": "query", "name": "objective", "schema": { "type": "string", "description": "\n Objective:\n - 1: Traffic\n - 2: App installs\n - 3: Conversions\n - 4: Video views\n - 5: Reach\n - 6: Lead generation\n - 7: Product sales\n ", "enum": [ "1", "2", "3", "4", "5", "6", "7" ] } }, { "in": "query", "name": "industry", "schema": { "type": "string", "description": "Head to [here](https://gist.githubusercontent.com/apiboxguru/d36908ea2bbe307e81bcc09ccf59616b/raw/302b5a442df9a6efced1dc430fd64d10a8226aeb/tiktok-ads-industry-code.json) for a full list of Industry code. You can combine multiple industries by using a comma. For example: 22102000000,22101000000" } }, { "in": "query", "name": "ad_language", "schema": { "type": "string", "description": "Ads language. Supported language: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko", "enum": [ "en", "es", "ar", "vi", "th", "de", "id", "pt", "fr", "ms", "nl", "ja", "it", "ro", "zh-Hant", "ko" ] } }, { "in": "query", "name": "keyword", "schema": { "type": "string", "description": "Search ads keyword" } } ], "summary": "Get Top Ads", "description": "Get Top Ads", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/ads/detail": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "ad_title": { "type": "string", "description": "", "example": "Hurry up! 40%OFF TODAY" }, "brand_name": { "type": "string", "description": "", "example": "light'f ™️" }, "comment": { "type": "number", "description": "", "example": 491 }, "cost": { "type": "number", "description": "", "example": 2 }, "country_code": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "US", "CA", "ES", "CZ", "NO", "Pl", "IE" ] }, "ctr": { "type": "number", "description": "", "example": 0.07 }, "favorite": { "type": "boolean", "description": "", "example": false }, "has_summary": { "type": "boolean", "description": "", "example": true }, "highlight_text": { "type": "string", "description": "", "example": "" }, "id": { "type": "string", "description": "", "example": "7169172119488577537" }, "industry_key": { "type": "string", "description": "", "example": "label_21102000000" }, "is_search": { "type": "boolean", "description": "", "example": false }, "keyword_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "rain humidifier diffuser", "anxiety and insomnia", "this has effectively overcome insomnia", "get your now selling fast", "limited time offer ending today" ] }, "landing_page": { "type": "string", "description": "", "example": "https://scosy.store/products/lightf-raining-night-diffuser" }, "like": { "type": "number", "description": "", "example": 342846 }, "objective_key": { "type": "string", "description": "", "example": "campaign_objective_conversion" }, "objectives": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "", "example": "campaign_objective_conversion" }, "value": { "type": "number", "description": "", "example": 3 } } } }, "pattern_label": { "type": "array", "items": { "type": "string" }, "description": "", "example": [] }, "share": { "type": "number", "description": "", "example": 16395 }, "source": { "type": "string", "description": "", "example": "TikTok Ads Manager" }, "source_key": { "type": "number", "description": "", "example": 1 }, "tag": { "type": "number", "description": "", "example": 3 }, "video_info": { "type": "object", "properties": { "vid": { "type": "string", "description": "", "example": "v10033g50000d2k6t07og65kn3s9joeg" }, "duration": { "type": "number", "description": "", "example": 45.3 }, "cover": { "type": "string", "description": "", "example": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0051c001-sg/ocGQSgdBQCzUEIIRQeb3GpSDJ0f6NAwfB4AQLR~tplv-noop.image?dr=18692&refresh_token=5ce92a80&x-expires=1765825729&x-signature=7aK%2Fsq52VCl3%2FudAH98l3Ekbyb4%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my" }, "video_url": { "type": "object", "properties": { "720p": { "type": "string", "description": "", "example": "https://v16m-default.tiktokcdn.com/8b4cc8c593174434cd367fd6d9582ada/69405cc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/okqGXQ0MAhRCJ0nW8XRbDAAlgxqefUR3NB3aeg/?a=0&bti=NTU4QDM1NGA%3D&ch=0&cr=0&dr=0&lr=tiktok_business&cd=0%7C0%7C1%7C0&cv=1&br=1570&bt=785&cs=0&ds=3&ft=cApXJCz7ThWHrs0-1GZmo0P&mime_type=video_mp4&qs=0&rc=ZDs2aDs6N2loZThlPDU7O0BpanI8Nm45cjM5NTMzODYzNEBiLjBhXzI1XjUxNi9jMF9hYSNiZ3BrMmQ0cWhhLS1kMC1zcw%3D%3D&vvpl=1&l=20251215210804481E21104311144D334E&btag=e00088000" } } }, "width": { "type": "number", "description": "", "example": 576 }, "height": { "type": "number", "description": "", "example": 1024 } } }, "voice_over": { "type": "boolean", "description": "", "example": true } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingAdsDetail", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "ads_id", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Ads ID", "example": "7169172119488577537" }, "required": true } ], "summary": "Get Ads Detail", "description": "Get Ads Detail", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/keyword": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "keyword_list": { "type": "array", "items": { "type": "object", "properties": { "comment": { "type": "number", "description": "", "example": 2000 }, "cost": { "type": "number", "description": "", "example": 272000 }, "cpa": { "type": "number", "description": "", "example": 9.93 }, "ctr": { "type": "number", "description": "", "example": 1.71 }, "cvr": { "type": "number", "description": "", "example": 11.24 }, "impression": { "type": "number", "description": "", "example": 31800000 }, "keyword": { "type": "string", "description": "", "example": "christmas" }, "like": { "type": "number", "description": "", "example": 127005 }, "play_six_rate": { "type": "number", "description": "", "example": 11.45 }, "post": { "type": "number", "description": "", "example": 31900 }, "post_change": { "type": "number", "description": "", "example": 111.83 }, "share": { "type": "number", "description": "", "example": 4038 }, "video_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "7578816747088661791", "7576793446401314065", "7578693746087234846", "7559636960327896375", "7570571645098757389" ] } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingKeyword", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 7, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n - 120: Last 120 days\n ", "enum": [7, 30, 120], "example": 7 } }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" } }, { "in": "query", "name": "industry", "schema": { "type": "string", "description": "Head to [here](https://gist.githubusercontent.com/apiboxguru/d36908ea2bbe307e81bcc09ccf59616b/raw/302b5a442df9a6efced1dc430fd64d10a8226aeb/tiktok-ads-industry-code.json) for a full list of Industry code. You can combine multiple industries by using a comma. For example: 22102000000,22101000000" } }, { "in": "query", "name": "objective", "schema": { "type": "string", "description": "\n Objective:\n - 1: Traffic\n - 2: App Installs\n - 3: Conversions\n - 4: Video Views\n - 5: Reach\n - 8: Lead Generation\n - 14: Product Sales\n\n You can combine multiple objectives by using a comma. For example: 1,2\n ", "enum": [ "1", "2", "3", "4", "5", "8", "14" ] } }, { "in": "query", "name": "keyword_type", "schema": { "type": "string", "description": "\n Objective:\n - 1: Selling points\n - 2: Pain points\n - 3: Target audience\n - 4: Call-to-action\n - 5: Other\n - 6: Products\n\n You can combine multiple objectives by using a comma. For example: 1,2\n ", "enum": [ "1", "2", "3", "4", "5", "6" ] } } ], "summary": "Get Trending Keyword", "description": "Get Trending Keyword", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/keyword/sentence": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "sentence_list": { "type": "array", "items": { "type": "object", "properties": { "covers": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "ttps://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oEcYSAqB0Amw198ii9ceqAEXCicXPiYA8IIJ0k~tplv-noop.image?dr=18692&refresh_token=95b64430&x-expires=1765876851&x-signature=KbD1x0YmOVMLcWsfaEqMGsTVg4M%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my" ] }, "ctr": { "type": "number", "description": "", "example": 100 }, "cvr": { "type": "number", "description": "", "example": 0 }, "sentence": { "type": "string", "description": "", "example": "#tiktokshopblackfriday #homeandelectronicsdeals #tiktokshopholidayhaul #tiktokshopcybermonday #kidstoys" }, "use_type": { "type": "string", "description": "", "example": "script_use_type_title" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingKeywordSentence", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "description": "Keyword", "example": "toy" }, "required": true }, { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 }, "required": false }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 50, "description": "Number of items per page (maximum is 50)", "example": 50, "maximum": 50 }, "required": false }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 7, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n - 120: Last 120 days\n ", "enum": [7, 30, 120], "example": 7 }, "required": false }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" }, "required": false }, { "in": "query", "name": "order_type", "schema": { "type": "string", "description": "Order by type", "enum": [ "desc", "asc" ], "default": "desc", "example": "desc" }, "required": false } ], "summary": "Get Keyword Sentence", "description": "Get Keyword Sentence", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/keyword/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "video_list": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "7566475062321188151", "7573530016827395341", "7571142761429208334", "7519869818820971806", "7568328516127771916", "7579240711766232333", "7510555158892432686", "7552342464133188919", "7579905803046391095", "7507663122698603819" ] } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingKeywordPosts", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "keyword", "schema": { "type": "string", "description": "Keyword", "example": "toy" }, "required": true }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" }, "required": false }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 10, "description": "Number of items per page (maximum is 10)", "example": 10, "maximum": 10 }, "required": false }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 7, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n - 120: Last 120 days\n ", "enum": [7, 30, 120], "example": 7 }, "required": false } ], "summary": "Get Trending Video By Keyword", "description": "Get Trending Video By Keyword", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/hashtag": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "list": { "type": "array", "items": { "type": "object", "properties": { "hashtag_id": { "type": "string", "description": "", "example": "7415820094837948446" }, "hashtag_name": { "type": "string", "description": "", "example": "tiktokshopholidayhaul" }, "country_info": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "US" }, "value": { "type": "string", "description": "", "example": "United States" }, "label": { "type": "string", "description": "", "example": "US" } } }, "industry_info": { "type": "object", "properties": { "id": { "type": "number", "description": "", "example": 22000000000 }, "value": { "type": "string", "description": "", "example": "Apparel & Accessories" }, "label": { "type": "string", "description": "", "example": "label_22000000000" } } }, "is_promoted": { "type": "boolean", "description": "", "example": false }, "trend": { "type": "array", "items": { "type": "object", "properties": { "time": { "type": "number", "description": "", "example": 1763251200 }, "value": { "type": "number", "description": "", "example": 0.21 } } } }, "publish_cnt": { "type": "number", "description": "", "example": 1083553 }, "video_views": { "type": "number", "description": "", "example": 2049831890 }, "rank": { "type": "number", "description": "", "example": 1 }, "rank_diff": { "type": "number", "description": "", "example": 0 }, "rank_diff_type": { "type": "number", "description": "", "example": 2 } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingHashtag", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 7, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n - 120: Last 120 days\n ", "enum": [7, 30, 120], "example": 7 } }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" } }, { "in": "query", "name": "sort_by", "schema": { "type": "string", "description": "Sort by", "default": "popular", "example": "popular" } }, { "in": "query", "name": "industry_id", "schema": { "type": "string", "description": "Head to [here](https://gist.githubusercontent.com/apiboxguru/d36908ea2bbe307e81bcc09ccf59616b/raw/302b5a442df9a6efced1dc430fd64d10a8226aeb/tiktok-ads-industry-code.json) for a full list of Industry code. You can combine multiple industries by using a comma. For example: 22102000000,22101000000" } } ], "summary": "Get Trending Hashtag", "description": "Get Trending Hashtag", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/song": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "sound_list": { "type": "array", "items": { "type": "object", "properties": { "author": { "type": "string", "description": "", "example": "Mj_splatt" }, "clip_id": { "type": "string", "description": "", "example": "7570482709841037328" }, "country_code": { "type": "string", "description": "", "example": "US" }, "cover": { "type": "string", "description": "", "example": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oMvpDABpEBBiAA3mftCgEMAioePpWHQX9t7ZQy.jpeg" }, "duration": { "type": "number", "description": "", "example": 60 }, "if_cml": { "type": "boolean", "description": "", "example": false }, "is_search": { "type": "boolean", "description": "", "example": false }, "link": { "type": "string", "description": "", "example": "https://www.tiktok.com/music/x-7570482709841037328" }, "on_list_times": { "type": [ "string", "null" ], "description": "", "example": null }, "promoted": { "type": "boolean", "description": "", "example": false }, "rank": { "type": "number", "description": "", "example": 1 }, "rank_diff": { "type": "number", "description": "", "example": 0 }, "rank_diff_type": { "type": "number", "description": "", "example": 2 }, "related_items": { "type": "array", "items": { "type": "object", "properties": { "item_id": { "type": "number", "description": "", "example": 7.57911640692348e+18 }, "cover_uri": { "type": "string", "description": "", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oAIf8NjIQHAeLQBcGSQApgPfkCLp03XGNbs1iI~tplv-noop.image?dr=18692&refresh_token=3cf2bd9f&x-expires=1765830304&x-signature=WTXEqnMXadVwzw4t4iCCAIYGWvU%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my" } } } }, "song_id": { "type": "string", "description": "", "example": "7570493055201658881" }, "title": { "type": "string", "description": "", "example": "Justfallinlovewme" }, "trend": { "type": "array", "items": { "type": "object", "properties": { "time": { "type": "number", "description": "", "example": 1765152000 }, "value": { "type": "number", "description": "", "example": 0.86 } } } }, "url_title": { "type": "string", "description": "", "example": "Justfallinlovewme" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingSong", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 7, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n - 120: Last 120 days\n ", "enum": [7, 30, 120], "example": 7 } }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" } }, { "in": "query", "name": "rank_type", "schema": { "type": "string", "description": "\n Rank type:\n - popular: Popular\n - surging: Breakout\n ", "enum": [ "popular", "surging" ], "default": "popular", "example": "popular" } }, { "in": "query", "name": "new_on_board", "schema": { "type": "string", "description": "Is new on board", "enum": [ "true", "false" ], "default": "false", "example": "false" } }, { "in": "query", "name": "commercial_music", "schema": { "type": "string", "description": "Is commercial music", "enum": [ "true", "false" ], "default": "false", "example": "false" } } ], "summary": "Get Trending Song", "description": "Get Trending Song", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/creator": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "creators": { "type": "array", "items": { "type": "object", "properties": { "tcm_id": { "type": "string", "description": "", "example": "7414477993612935173" }, "user_id": { "type": "string", "description": "", "example": "62133858422239232" }, "nick_name": { "type": "string", "description": "", "example": "Fernanda" }, "avatar_url": { "type": "string", "description": "", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/3fa0e612da6c7528e77ef65fbb79a932~tplv-tiktokx-cropcenter:100:100.png?dr=14579&refresh_token=582025f1&x-expires=1765980000&x-signature=%2FB5JXe3x6EpvbAkG9V7vZSR6Tfg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=317596d8&idc=my" }, "country_code": { "type": "string", "description": "", "example": "US" }, "follower_cnt": { "type": "number", "description": "", "example": 9135515 }, "liked_cnt": { "type": "number", "description": "", "example": 668294555 }, "tt_link": { "type": "string", "description": "", "example": "https://www.tiktok.com/@ferchugimenez" }, "tcm_link": { "type": "string", "description": "", "example": "https://creatormarketplace.tiktok.com/ad#/author/7414477993612935173" }, "items": { "type": "array", "items": { "type": "object", "properties": { "item_id": { "type": "string", "description": "", "example": "7444674312784645432" }, "cover_url": { "type": "string", "description": "", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/oQIBhn2EeBMUWQR5wVQACFEBtlDxgUDdAfoB8J~tplv-noop.image?dr=18692&refresh_token=c200df0d&x-expires=1765831046&x-signature=5VYpmHh9pxYh60vgof9EJnKScag%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my" }, "tt_link": { "type": "string", "description": "", "example": "https://www.tiktok.com/@author/video/7444674312784645432" }, "vv": { "type": "number", "description": "", "example": 13733332 }, "liked_cnt": { "type": "number", "description": "", "example": 516217 }, "create_time": { "type": "number", "description": "", "example": 1733348322 } } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingCreator", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "sort_by", "schema": { "type": "string", "description": "\n Sort by:\n - follower: Follower\n - engagement: Engagement\n - avg_views: Popularity\n ", "enum": [ "follower", "engagement", "avg_views" ], "default": "follower", "example": "follower" } }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" } }, { "in": "query", "name": "audience_count", "schema": { "type": "string", "description": "\n Audience count:\n - 1: 10k -\u003E 100k\n - 2: 100k -\u003E 1m\n - 3: 1m -\u003E 10m\n - 4: \u003E 10m\n ", "enum": [ "1", "2", "3", "4" ] } }, { "in": "query", "name": "audience_country", "schema": { "type": "string", "description": "Audience country code. Head Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries" } } ], "summary": "Get Trending Creator", "description": "Get Trending Creator", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/video": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "videos": { "type": "array", "items": { "type": "object", "properties": { "country_code": { "type": "string", "description": "", "example": "US" }, "cover": { "type": "string", "description": "", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o0ECfIeIFAM1Svaq1QCuj3AKhVIfLvIlGZQVXx~tplv-noop.image?dr=18692&refresh_token=e26c5adb&x-expires=1765888887&x-signature=W00Uqo9E7H1FQbKCnK5rEnqqUA0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=83ba07fd&idc=my" }, "duration": { "type": "number", "description": "", "example": 159 }, "id": { "type": "string", "description": "", "example": "7572995879557139742" }, "item_id": { "type": "string", "description": "", "example": "7572995879557139742" }, "item_url": { "type": "string", "description": "", "example": "https://www.tiktok.com/@mnm_pipi/video/7572995879557139742" }, "region": { "type": "string", "description": "", "example": "United States" }, "title": { "type": "string", "description": "", "example": "maybe the best day of my life 🥹💚🎄🐱 #angeltree #walmart gifting a support cat for Christmas with Angel Gift Tree" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingVideo", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "period", "schema": { "type": "number", "default": 30, "description": "\n Period in days:\n - 7: Last 7 days\n - 30: Last 30 days\n ", "enum": [7, 30], "example": 30 } }, { "in": "query", "name": "order_by", "schema": { "type": "string", "description": "\n Order by:\n - vv: Hot\n - like: Like\n - comment: Comment\n - repost: share\n ", "enum": [ "vv", "like", "comment", "repost" ], "default": "vv", "example": "vv" } }, { "in": "query", "name": "country", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" } } ], "summary": "Get Trending Video", "description": "Get Trending Video", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/commercial-music-library": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "list": { "type": "array", "items": { "type": "object", "properties": { "clip_id": { "type": "string", "description": "", "example": "7467591415728801793" }, "detail": { "type": "string", "description": "", "example": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oQVzDffgtEKQMWNCBOngFBOPI5ZzCmnVnBM1ms" }, "duration": { "type": "number", "description": "", "example": 60 }, "genre": { "type": "string", "description": "", "example": "Electronic" }, "meta_song_id": { "type": "string", "description": "", "example": "0" }, "mood": { "type": "string", "description": "", "example": "Dynamic" }, "music_id": { "type": "string", "description": "", "example": "7467591415728801793" }, "music_url": { "type": "string", "description": "", "example": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oQVzDffgtEKQMWNCBOngFBOPI5ZzCmnVnBM1ms" }, "placement_allowed": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "Tiktok" ] }, "poster_url": { "type": "string", "description": "", "example": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/o8EAX0QWiAeAMws6xqEBAiiA9vBo3CAhmP2KSo.jpeg" }, "singer": { "type": "string", "description": "", "example": "nimino" }, "theme": { "type": "string", "description": "", "example": "Dance" }, "title": { "type": "string", "description": "", "example": "Glow" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingCommercial-music-library", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "region", "schema": { "type": "string", "description": "Region", "example": "US", "default": "US" } }, { "in": "query", "name": "scenarios", "schema": { "type": "string", "description": "\n Scenarios:\n - 0: TikTok Commercial Use\n - 1: TikTok Series\n ", "enum": [ "0", "1" ], "default": "0", "example": "0" } }, { "in": "query", "name": "duration", "schema": { "type": "string", "description": "\n Scenarios:\n - 0: All\n - 1: 0~20s\n - 2: 20~40s\n - 3: 40~60s\n - 4: Over 60s\n ", "enum": [ "0", "1", "2", "3", "4" ], "default": "0", "example": "0" } }, { "in": "query", "name": "placements", "schema": { "type": "string", "description": "", "default": "[]" } }, { "in": "query", "name": "themes", "schema": { "type": "string", "description": "", "default": "[]" } }, { "in": "query", "name": "genres", "schema": { "type": "string", "description": "", "default": "[]" } }, { "in": "query", "name": "moods", "schema": { "type": "string", "description": "", "default": "[]" } }, { "in": "query", "name": "music_name", "schema": { "type": "string", "description": "" } }, { "in": "query", "name": "singer_name", "schema": { "type": "string", "description": "" } } ], "summary": "Get Commercial Music Library", "description": "Get Commercial Music Library", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/commercial-music-library/playlist": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "playlist_id": { "type": "number", "description": "", "example": 6.87525091521805e+18 }, "poster_url": { "type": "string", "description": "", "example": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/o8EAX0QWiAeAMws6xqEBAiiA9vBo3CAhmP2KSo.jpeg" }, "title": { "type": "string", "description": "", "example": "TikTok Viral" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingCommercial-music-libraryPlaylist", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 } }, { "in": "query", "name": "region", "schema": { "type": "string", "description": "Region", "example": "US", "default": "US" } } ], "summary": "Get Commercial Music Playlist", "description": "Get Commercial Music Playlist", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/commercial-music-library/playlist/detail": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "music_list": { "type": "array", "items": { "type": "object", "properties": { "clip_id": { "type": "string", "description": "", "example": "7467591415728801793" }, "detail": { "type": "string", "description": "", "example": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oQVzDffgtEKQMWNCBOngFBOPI5ZzCmnVnBM1ms" }, "duration": { "type": "number", "description": "", "example": 60 }, "genre": { "type": "string", "description": "", "example": "Electronic" }, "meta_song_id": { "type": "string", "description": "", "example": "0" }, "mood": { "type": "string", "description": "", "example": "Dynamic" }, "music_id": { "type": "string", "description": "", "example": "7467591415728801793" }, "music_url": { "type": "string", "description": "", "example": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oQVzDffgtEKQMWNCBOngFBOPI5ZzCmnVnBM1ms" }, "placement_allowed": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "Tiktok" ] }, "poster_url": { "type": "string", "description": "", "example": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/o8EAX0QWiAeAMws6xqEBAiiA9vBo3CAhmP2KSo.jpeg" }, "singer": { "type": "string", "description": "", "example": "nimino" }, "theme": { "type": "string", "description": "", "example": "Dance" }, "title": { "type": "string", "description": "", "example": "Glow" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingCommercial-music-libraryPlaylistDetail", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "playlist_id", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Playlist ID", "example": "6929526806429469442" }, "required": true }, { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 }, "required": false }, { "in": "query", "name": "limit", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 20, "description": "Number of items per page (maximum is 20)", "example": 20, "maximum": 20 }, "required": false }, { "in": "query", "name": "region", "schema": { "type": "string", "description": "Region", "example": "US", "default": "US" }, "required": false } ], "summary": "Get Commercial Music Playlist Detail", "description": "Get Commercial Music Playlist Detail", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/top-products": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "has_more": { "type": "boolean", "description": "", "example": true }, "page": { "type": "number", "description": "", "example": 1 }, "size": { "type": "number", "description": "", "example": 20 }, "total_count": { "type": "number", "description": "", "example": 500 } } }, "list": { "type": "array", "items": { "type": "object", "properties": { "comment": { "type": "number", "description": "", "example": 72 }, "cost": { "type": "number", "description": "", "example": 4660 }, "cover_url": { "type": [ "string", "null" ], "description": "", "example": null }, "cpa": { "type": "number", "description": "", "example": 3.22 }, "ctr": { "type": "number", "description": "", "example": 2.16 }, "cvr": { "type": "number", "description": "", "example": 7.76 }, "ecom_type": { "type": "string", "description": "", "example": "13" }, "first_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "605196" }, "label": { "type": "string", "description": "", "example": "category_605196" }, "value": { "type": "string", "description": "", "example": "Automotive & Motorbike" } } }, "impression": { "type": "number", "description": "", "example": 1740000 }, "like": { "type": "number", "description": "", "example": 3004 }, "play_six_rate": { "type": "number", "description": "", "example": 8.94 }, "post": { "type": "number", "description": "", "example": 123 }, "post_change": { "type": "number", "description": "", "example": 2.13 }, "second_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "940808" }, "label": { "type": "string", "description": "", "example": "category_940808" }, "parent_id": { "type": "string", "description": "", "example": "605196" }, "value": { "type": "string", "description": "", "example": "Vehicle Washing & Maintenance" } } }, "share": { "type": "number", "description": "", "example": 109 }, "third_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "940808" }, "label": { "type": "string", "description": "", "example": "category_940808" }, "parent_id": { "type": "string", "description": "", "example": "605196" }, "value": { "type": "string", "description": "", "example": "Vehicle Washing & Maintenance" } } }, "url_title": { "type": "string", "description": "", "example": "Cleaning-Care-Fluids" } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingTop-products", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "page", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 1, "description": "Page", "example": 1 } }, { "in": "query", "name": "last", "schema": { "type": "number", "default": 7, "description": "\n Last in days:\n - 1: Yesterday\n - 7: Last 7 days\n - 30: Last 30 days\n ", "enum": [7, 30, 120], "example": 7 } }, { "in": "query", "name": "order_by", "schema": { "type": "string", "description": "\n Order by:\n - post: Popularity\n - post_change: Popularity change\n - ctr: CTR\n - cvr: CVR\n - cpa: CPA\n - cost: Cost\n - like: Like\n - share: Share\n - comment: Comment\n - impression: Impression\n - play_six_rate: 6s view rate\n ", "enum": [ "post", "post_change", "ctr", "cvr", "cpa", "cost", "like", "share", "comment", "impression", "play_six_rate" ], "default": "post", "example": "post" } }, { "in": "query", "name": "country_code", "schema": { "type": "string", "description": "Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries", "default": "US", "example": "US" } }, { "in": "query", "name": "keyword", "schema": { "type": "string", "description": "Search Keyword" } }, { "in": "query", "name": "category_id", "schema": { "type": "string", "description": "\n Category ID:\n - 605196: Automotive & Motorbike\n - 602284: Baby & Maternity\n - 601450: Beauty & Personal Care\n - 801928: Books, Magazines & Audio\n - 951432: Collectibles\n - 601755: Computers & Office Equipment\n - 605248: Fashion Accessories\n - 700437: Food & Beverages\n - 604453: Furniture\n - 700645: Health\n - 604968: Home Improvement\n - 600001: Home Supplies\n - 600942: Household Appliances\n - 953224: Jewellery, Accessories & Derivatives\n - 802184: Kids Fashion\n - 600024: Kitchenware\n - 824584: Luggage & Bags\n - 824328: Menswear & Men's Underwear\n - 601303: Muslim Fashion\n - 602118: Pet Supplies\n - 601739: Phones & Electronics\n - 601352: Shoes\n - 603014: Sports & Outdoor\n - 600154: Textiles & Soft Furnishings\n - 604579: Tools & Hardware\n - 604206: Toys & Hobbies\n - 834312: Virtual Products\n - 601152: Womenswear & Women's Underwear\n ", "enum": [ "605196", "602284", "601450", "801928", "951432", "601755", "605248", "700437", "604453", "700645", "604968", "600001", "600942", "953224", "802184", "600024", "824584", "824328", "601303", "602118", "601739", "601352", "603014", "600154", "604579", "604206", "834312", "601152" ], "example": "601739" } }, { "in": "query", "name": "week", "schema": { "type": "string", "description": "", "example": "2025-07-06" } }, { "in": "query", "name": "month", "schema": { "type": "string", "description": "", "example": "2024-04" } } ], "summary": "Get Top Products", "description": "Get Top Products", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/top-products/metrics": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "info": { "type": "object", "properties": { "comment": { "type": "number", "description": "", "example": 72 }, "cost": { "type": "number", "description": "", "example": 4660 }, "cover_url": { "type": [ "string", "null" ], "description": "", "example": null }, "cpa": { "type": "number", "description": "", "example": 3.22 }, "ctr": { "type": "number", "description": "", "example": 2.16 }, "cvr": { "type": "number", "description": "", "example": 7.76 }, "ecom_type": { "type": "string", "description": "", "example": "13" }, "first_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "605196" }, "label": { "type": "string", "description": "", "example": "category_605196" }, "value": { "type": "string", "description": "", "example": "Automotive & Motorbike" } } }, "impression": { "type": "number", "description": "", "example": 1740000 }, "like": { "type": "number", "description": "", "example": 3004 }, "play_six_rate": { "type": "number", "description": "", "example": 8.94 }, "post": { "type": "number", "description": "", "example": 123 }, "post_change": { "type": "number", "description": "", "example": 2.13 }, "second_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "940808" }, "label": { "type": "string", "description": "", "example": "category_940808" }, "parent_id": { "type": "string", "description": "", "example": "605196" }, "value": { "type": "string", "description": "", "example": "Vehicle Washing & Maintenance" } } }, "share": { "type": "number", "description": "", "example": 109 }, "third_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "940808" }, "label": { "type": "string", "description": "", "example": "category_940808" }, "parent_id": { "type": "string", "description": "", "example": "605196" }, "value": { "type": "string", "description": "", "example": "Vehicle Washing & Maintenance" } } }, "url_title": { "type": "string", "description": "", "example": "Cleaning-Care-Fluids" }, "ctr_metrics": { "type": "array", "items": { "type": "object", "properties": { "time": { "type": "number", "description": "", "example": 1763251200 }, "value": { "type": "number", "description": "", "example": 3.73 } } } }, "post_metrics": { "type": "array", "items": { "type": "object", "properties": { "time": { "type": "number", "description": "", "example": 1763251200 }, "value": { "type": "number", "description": "", "example": 3.73 } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingTop-productsMetrics", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "product_id", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Product ID", "example": "601226" }, "required": true } ], "summary": "Get Top Product Metrics", "description": "Get Top Product Metrics", "security": [ { "apiKeyAuth": [] } ] } }, "/api/trending/top-products/detail": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "type": "object", "properties": { "audience_ages": { "type": [ "string", "null" ], "description": "", "example": null }, "audience_interests": { "type": "array", "items": { "type": "string" }, "description": "", "example": [] }, "cover_url": { "type": "string", "description": "", "example": "https://p19-cc-sign-sg.tiktokcdn.com/tos-maliva-i-o3syd03w52-us/9b034856657c4453b5d7f49374061e5d~tplv-yenboaefse-image.jpeg?lk3s=317596d8&x-expires=1768398902&x-signature=1S02fT%2BzA%2B2JYLjRL%2FugKgVTWvM%3D" }, "ecom_type": { "type": "string", "description": "", "example": "13" }, "first_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "605196" }, "label": { "type": "string", "description": "", "example": "category_605196" }, "value": { "type": "string", "description": "", "example": "Automotive & Motorbike" } } }, "hashtags": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "outfit", "flypシ", "story", "onepiece", "jesus" ] }, "posts": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "7472308160007802158", "7244069684193070342", "7413067122605165841" ] }, "second_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "940808" }, "label": { "type": "string", "description": "", "example": "category_940808" }, "parent_id": { "type": "string", "description": "", "example": "605196" }, "value": { "type": "string", "description": "", "example": "Vehicle Washing & Maintenance" } } }, "third_ecom_category": { "type": "object", "properties": { "id": { "type": "string", "description": "", "example": "940808" }, "label": { "type": "string", "description": "", "example": "category_940808" }, "parent_id": { "type": "string", "description": "", "example": "605196" }, "value": { "type": "string", "description": "", "example": "Vehicle Washing & Maintenance" } } }, "url_title": { "type": "string", "description": "", "example": "T-Shirts" } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiTrendingTop-productsDetail", "tags": [ "Trending" ], "parameters": [ { "in": "query", "name": "product_id", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Product ID", "example": "601226" }, "required": true } ], "summary": "Get Top Product Detail", "description": "Get Top Product Detail", "security": [ { "apiKeyAuth": [] } ] } }, "/api/challenge/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "challengeInfo": { "type": "object", "properties": { "challenge": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } }, "challengeAnnouncement": { "type": "object", "properties": { "body": { "type": "string", "description": "Announcement body to the challenge", "example": "" }, "title": { "type": "string", "description": "Title of the challenge announcement", "example": "" } } }, "stats": { "type": "object", "properties": { "videoCount": { "type": "number", "description": "Total number of videos using this hashtag", "deprecated": true, "example": 0 }, "viewCount": { "type": "number", "description": "Total number of views for videos using this hashtag", "example": 105813400000000 } } }, "statsV2": { "type": "object", "properties": { "videoCount": { "type": "string", "description": "Total number of videos using this hashtag", "example": "8050268855" }, "viewCount": { "type": "string", "description": "Total number of views for videos using this hashtag", "example": "105813438690569" } } } } }, "statusCode": { "type": "number", "description": " Status Code\n - 0: Success\n - 10205: Not found\n ", "example": 0 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiChallengeInfo", "tags": [ "Challenge (Hashtag)" ], "parameters": [ { "in": "query", "name": "challengeName", "schema": { "type": "string", "minLength": 1, "description": "Challenge name", "example": "fyp" }, "required": true } ], "summary": "Get Challenge Info", "description": "Get Challenge Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/challenge/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "30" }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiChallengePosts", "tags": [ "Challenge (Hashtag)" ], "parameters": [ { "in": "query", "name": "challengeId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Challenge ID", "example": "229207" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0", "example": "0" }, "required": false } ], "summary": "Get Challenge Posts", "description": "Get Challenge Posts", "security": [ { "apiKeyAuth": [] } ] } }, "/api/collection/info": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiCollectionInfo", "tags": [ "Collection" ], "parameters": [ { "in": "query", "name": "collectionId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Collection ID", "example": "7442134949027351314" }, "required": true } ], "summary": "Get Collection Info", "description": "Get Collection Info", "security": [ { "apiKeyAuth": [] } ] } }, "/api/collection/posts": { "get": { "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor for pagination. Use this value in subsequent requests to fetch more data", "example": "30" }, "hasMore": { "type": "boolean", "description": "Indicates whether there are more data available to fetch", "example": true }, "itemList": { "type": "array", "items": { "type": "object", "properties": { "AIGCDescription": { "type": "string", "description": "AI-generated description of the video, if available", "example": "" }, "CategoryType": { "type": "number", "description": "Indicates the video category type defined by TikTok", "example": 101 }, "author": { "type": "object", "properties": { "avatarLarger": { "type": "string", "description": "URL of the user’s large-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=44dee363&x-expires=1743199200&x-signature=%2BGEGvUBERYBrAM3WxRM7lBR%2BwHk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "avatarMedium": { "type": "string", "description": "URL of the user’s medium-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9014dbf4&x-expires=1743199200&x-signature=z0YrUAc7zL43tXzRLreiqXkp3UQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "avatarThumb": { "type": "string", "description": "URL of the user’s thumbnail-size avatar image", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f8c7cad75f3a12205d31d6662d2555d5~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5e79e1f7&x-expires=1743199200&x-signature=JC18MQX811ztSmm8YN5MdLNjViA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=my" }, "commentSetting": { "type": "number", "description": "User’s comment privacy setting for their posts", "example": 0 }, "downloadSetting": { "type": "number", "description": "User’s download permission setting for their videos", "example": 0 }, "duetSetting": { "type": "number", "description": "User’s duet permission setting", "example": 0 }, "ftc": { "type": "boolean", "description": "Indicates whether the account is subject to child safety restrictions", "example": false }, "id": { "type": "string", "description": "User ID", "example": "6881290705605477381" }, "isADVirtual": { "type": "boolean", "description": "Indicates whether the account is a virtual or advertisement related profile", "example": false }, "nickname": { "type": "string", "description": "The user’s profile display name", "example": "Taylor Swift" }, "openFavorite": { "type": "boolean", "description": "Whether the user’s liked videos list is public", "example": true }, "privateAccount": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "secUid": { "type": "string", "description": "User secUid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" }, "secret": { "type": "boolean", "description": "Indicates whether the account is set to private", "example": false }, "signature": { "type": "string", "description": "The user’s profile bio", "example": "This is pretty much just a cat account" }, "stitchSetting": { "type": "number", "description": "User’s Stitch permission setting", "example": 0 }, "ttSeller": { "type": "boolean", "description": "Indicates whether the user is registered as a TikTok Shop seller", "example": false }, "uniqueId": { "type": "string", "description": "User uniqueID. The user’s public TikTok handle (username)", "example": "taylorswift" }, "verified": { "type": "boolean", "description": "Indicates whether the account is officially verified", "example": true }, "UserStoryStatus": { "type": "number", "description": "Status of the user’s story feature:\n- `0`: no story\n- `1`: active story\n\n Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information.", "example": 0 } } }, "authorStats": { "type": "object", "properties": { "diggCount": { "type": "number", "description": "Total number of likes the user has given to other videos", "example": 2276 }, "followerCount": { "type": "number", "description": "Total number of users following this account", "example": 33300000 }, "followingCount": { "type": "number", "description": "Number of accounts this user is following", "example": 0 }, "friendCount": { "type": "number", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": 0 }, "heart": { "type": "number", "description": "Total number of likes the user has received across all videos", "example": 263500000 }, "heartCount": { "type": "number", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": 263500000 }, "videoCount": { "type": "number", "description": "Total number of videos the user has posted", "example": 78 } }, "description": "User stats" }, "authorStatsV2": { "type": "object", "properties": { "diggCount": { "type": "string", "description": "Total number of likes the user has given to other videos", "example": "2276" }, "followerCount": { "type": "string", "description": "Total number of users following this account", "example": "33265139" }, "followingCount": { "type": "string", "description": "Number of accounts this user is following", "example": "0" }, "friendCount": { "type": "string", "description": "Number of mutual followers (users that this account follows and who also follow back)", "example": "0" }, "heart": { "type": "string", "description": "Total number of likes the user has received across all videos", "example": "263479941" }, "heartCount": { "type": "string", "description": "Same as \"heart\". Represents the total number of likes the user has received", "example": "263479941" }, "videoCount": { "type": "string", "description": "Total number of videos the user has posted", "example": "78" } }, "description": "An enhanced version of user stats where all metrics are exact values (not rounded)" }, "backendSourceEventTracking": { "type": "string", "description": "Internal backend event tracking identifier used by TikTok", "example": "" }, "challenges": { "type": "array", "items": { "type": "object", "properties": { "coverLarger": { "type": "string", "description": "URL of the large cover image for the challenge", "example": "" }, "coverMedium": { "type": "string", "description": "URL of the medium cover image for the challenge", "example": "" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail cover image for the challenge", "example": "" }, "desc": { "type": "string", "description": "Description of the challenge", "example": "" }, "id": { "type": "string", "description": "Challenge ID", "example": "229207" }, "profileLarger": { "type": "string", "description": "URL of the large profile image associated with the challenge, if any", "example": "" }, "profileMedium": { "type": "string", "description": "URL of the medium profile image associated with the challenge, if any", "example": "" }, "profileThumb": { "type": "string", "description": "URL of the thumnail profile image associated with the challenge, if any", "example": "" }, "title": { "type": "string", "description": "Title or name of the challenge", "example": "fyp" } } } }, "contents": { "type": "array", "items": { "type": "object", "properties": { "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } } } } }, "createTime": { "type": "number", "description": "Unix timestamp indicating when the video was created", "example": 1763039850 }, "creatorAIComment": { "type": "object", "properties": { "eligibleVideo": { "type": "boolean", "description": "Indicates whether the video is eligible for AI-powered comments", "example": false }, "hasAITopic": { "type": "boolean", "description": "Indicates whether the video contains AI-generated topics", "example": false }, "notEligibleReason": { "type": "number", "description": "Reason code explaining why the video is not eligible for AI comments", "example": 101 } } }, "desc": { "type": "string", "description": "The text description of the video", "example": "Honestly can’t think of a better way to celebrate my (almost) birthday than to relive the Eras Tour with you! This time we’re going backstage. \"The End of an Era\", a 6-episode behind-the-scenes docuseries, streams on @Disney+ beginning Dec 12 🫶" }, "diversificationId": { "type": "number", "description": "Identifier used by TikTok to diversify video distribution", "example": 10088 }, "duetDisplay": { "type": "number", "description": "Indicates duet visibility settings for this video", "example": 0 }, "duetEnabled": { "type": "boolean", "description": "Indicates whether duets are allowed for this video", "example": true }, "forFriend": { "type": "boolean", "description": "Indicates whether the video is shared only with friends", "example": false }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "isAd": { "type": "boolean", "description": "Indicates whether the video is an advertisement", "example": false }, "isReviewing": { "type": "boolean", "description": "Indicates whether the video is still under TikTok review", "example": false }, "itemCommentStatus": { "type": "number", "description": "The comment status of the video", "example": 0 }, "item_control": { "type": "object", "properties": { "can_repost": { "type": "boolean", "description": "Indicates whether the video can be reposted by users", "example": true } } }, "music": { "type": "object", "properties": { "album": { "type": "string", "description": "Name of the album this music belongs to, if applicable", "example": "" }, "authorName": { "type": "string", "description": "Name of the music author or artist", "example": "Taylor Swift" }, "coverLarge": { "type": "string", "description": "URL of the large-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=18df4cd3&x-expires=1763632800&x-signature=RX9GiL%2FEZngDo3rcRA1tsqkQmuo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverMedium": { "type": "string", "description": "URL of the medium-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=614c3172&x-expires=1763632800&x-signature=d3Q%2FxhrnR1B1G9pX%2FJm60%2Fmgo9E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "coverThumb": { "type": "string", "description": "URL of the thumbnail-size cover image for the music", "example": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e9b90fd8&x-expires=1763632800&x-signature=%2BJ97ep4n2G7v%2F2MKOwBcj%2F9MR1E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my" }, "duration": { "type": "number", "description": "Duration of the music in seconds", "example": 60 }, "id": { "type": "string", "description": "Music ID", "example": "7556815852168759313" }, "isCopyrighted": { "type": "boolean", "description": "Indicates whether the music is copyrighted", "example": true }, "original": { "type": "boolean", "description": "Indicates whether this is an original sound created by the user", "example": true }, "playUrl": { "type": "string", "description": "Direct URL to play or download the music", "example": "https://v16m.tiktokcdn.com/fb3d5ac2c28d791b79c06cd9ceca27ef/691d9d5e/video/tos/maliva/tos-maliva-v-27dcd7c799-us/oI2Aep2tC9pUdvVpJz2BEJ4nmEEjEAFVAAAFfD/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThSPQcPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=MzwzaXE5cnV3NzMzaTU8NEBpMzwzaXE5cnV3NzMzaTU8NEBvZ2tzMmRjaF5hLS1kMTJzYSNvZ2tzMmRjaF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20251118183239BD2E13106ED74F0A522E&btag=e00050000&cc=3" }, "private": { "type": "boolean", "description": "Indicates whether the music is private and not publicly accessible", "example": false }, "title": { "type": "string", "description": "Title of the music track", "example": "original sound" }, "tt2dsp": { "type": "object", "description": "Internal object for TikTok DSP (digital service processing) data", "example": { } } } }, "officalItem": { "type": "boolean", "description": "Indicates whether the video is marked as official content", "example": false }, "originalItem": { "type": "boolean", "description": "Indicates whether this is original content by the creator", "example": false }, "privateItem": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "secret": { "type": "boolean", "description": "Indicates whether the video is set to private", "example": false }, "shareEnabled": { "type": "boolean", "description": "Indicates whether sharing is enabled for this video", "example": true }, "stats": { "type": "object", "properties": { "collectCount": { "type": "number", "description": "Number of times the post has been saved", "example": 49800 }, "commentCount": { "type": "number", "description": "Total number of comments on the post", "example": 10300 }, "diggCount": { "type": "number", "description": "Total number of likes the post has received", "example": 1100000 }, "playCount": { "type": "number", "description": "Total number of views the post has generated", "example": 6600000 }, "shareCount": { "type": "number", "description": "Number of times the post has been shared", "example": 100000 } } }, "statsV2": { "type": "object", "properties": { "collectCount": { "type": "string", "description": "Number of times the post has been saved", "example": "49811" }, "commentCount": { "type": "string", "description": "Total number of comments on the post", "example": "10300" }, "diggCount": { "type": "string", "description": "Total number of likes the post has received", "example": "1100000" }, "playCount": { "type": "string", "description": "Total number of views the post has generated", "example": "6600000" }, "repostCount": { "type": "string", "description": "Number of times the post has been reposted", "deprecated": true, "example": "0" }, "shareCount": { "type": "string", "description": "Number of times the post has been shared", "example": "100000" } } }, "stitchDisplay": { "type": "number", "description": "Indicates stitch visibility settings for this video", "example": 0 }, "stitchEnabled": { "type": "boolean", "description": "Indicates whether stitching is allowed for this video", "example": true }, "textExtra": { "type": "array", "items": { "type": "object", "properties": { "awemeId": { "type": "string", "description": "ID of the referenced video, if the text mentions another TikTok video", "example": "" }, "end": { "type": "number", "description": "Ending character index of the detected entity within the text", "example": 225 }, "hashtagName": { "type": "string", "description": "Hashtag detected in the text without the # symbol", "example": "" }, "isCommerce": { "type": "boolean", "description": "Indicates whether the detected entity is related to a commerce or promotional tag", "example": false }, "secUid": { "type": "string", "description": "secUid of the referenced user", "example": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL" }, "start": { "type": "number", "description": "Starting character index of the detected entity within the text", "example": 217 }, "subType": { "type": "number", "description": "Subtype identifier for more specific classification of the entity", "example": 9 }, "type": { "type": "number", "description": "Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference)", "example": 0 }, "userId": { "type": "string", "description": "User ID of the referenced user, if the text includes a mention", "example": "6844178288162063365" }, "userUniqueId": { "type": "string", "description": "Unique username of the referenced user", "example": "disneyplus" } } } }, "textLanguage": { "type": "string", "description": "Detected language of the caption text", "example": "en" }, "textTranslatable": { "type": "boolean", "description": "Indicates whether the caption text can be translated", "example": true }, "video": { "type": "object", "properties": { "PlayAddrStruct": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "VQScore": { "type": "string", "description": "Video quality score calculated by TikTok", "example": "59.15" }, "bitrate": { "type": "number", "description": "Average video bitrate in bits per second", "example": 1216082 }, "bitrateInfo": { "type": "array", "items": { "type": "object", "properties": { "Bitrate": { "type": "number", "description": "Indicates the video bitrate in bits per second", "example": 1216082 }, "BitrateFPS": { "type": "number", "description": "Frames per second associated with this bitrate", "example": 23 }, "CodecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "Format": { "type": "string", "description": "Video container or file format", "example": "mp4" }, "GearName": { "type": "string", "description": "Name of the transcoding gear or quality profile", "example": "normal_720_0" }, "MVMAF": { "type": "string", "description": "Stringified MVMAF data containing multi-resolution video quality metrics", "example": "\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\"" }, "PlayAddr": { "type": "object", "properties": { "DataSize": { "type": "number", "description": "Size of the video file in bytes", "example": 23052674 }, "FileCs": { "type": "string", "description": "File consistency signature used internally by TikTok", "example": "c:0-92603-ae77" }, "FileHash": { "type": "string", "description": "Hash value of the video file used for validation", "example": "7e8bab4b791853b66673979351d35121" }, "Height": { "type": "number", "description": "Height of the video in pixels", "example": 1280 }, "Uri": { "type": "string", "description": "Internal TikTok URI reference for the video file", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "UrlKey": { "type": "string", "description": "Internal key used by TikTok CDN to map to the actual video file", "example": "v15044gf0000d4atkifog65skk2ktp00_h264_720p_1216082" }, "UrlList": { "type": "array", "items": { "type": "string" }, "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": [ "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://v19-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token", "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=9ceb5bc73d9c47afa569a01ddb22f437&is_play_url=1&item_id=7572198435487501598&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjJhMmZhMTM0Mzc3MDViNjc2MWNhYmE0MTRlNzA4Yzc2&tk=tt_chain_token&urlt=1&video_id=v15044gf0000d4atkifog65skk2ktp00" ] }, "Width": { "type": "number", "description": "Width of the video in pixels", "example": 720 } } }, "QualityType": { "type": "number", "description": "Internal quality type indicator used by TikTok", "example": 10 }, "VideoExtra": { "type": "string", "description": "Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores", "example": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 239201}, {\\\"time\\\": 2, \\\"offset\\\": 366490}, {\\\"time\\\": 3, \\\"offset\\\": 527359}, {\\\"time\\\": 4, \\\"offset\\\": 630420}, {\\\"time\\\": 5, \\\"offset\\\": 739202}, {\\\"time\\\": 10, \\\"offset\\\": 1033489}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": -1, \\\"v960\\\": -1, \\\"v864\\\": -1, \\\"v720\\\": -1}, \\\"ori\\\": {\\\"v1080\\\": 86.983, \\\"v960\\\": 88.987, \\\"v864\\\": 90.935, \\\"v720\\\": 93.287}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"03d260a050ac518c3e2bcdc9d6ee5088\",\"dec_info\":\"\",\"gearvqm\":\"\",\"audio_bit_rate\":64079}" } } } }, "claInfo": { "type": "object", "properties": { "enableAutoCaption": { "type": "boolean", "description": "Indicates whether auto-generated captions are enabled", "example": true }, "hasOriginalAudio": { "type": "boolean", "description": "Indicates whether the video contains original audio", "example": true }, "noCaptionReason": { "type": "number", "description": "Reason code explaining why captions are unavailable", "example": 1 } } }, "codecType": { "type": "string", "description": "Video codec used for encoding", "example": "h264" }, "cover": { "type": "string", "description": "URL of the primary video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "definition": { "type": "string", "description": "Human-readable video resolution label", "example": "720p" }, "downloadAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/ow0iBf8kCiYqEo25pQ0AiAQVIuIuAYOAciMUVN/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2202&bt=1101&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Z2k2aDc3aWQ7Njk8ODpmaEBpM3NubnY5cmx3NzMzaTczNEBiNTAyNGA1NmAxMl4xXjRiYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=2a45032221ace6e91dc7c65424449ca7&tk=tt_chain_token" }, "duration": { "type": "number", "description": "Video duration in seconds", "example": 151 }, "dynamicCover": { "type": "string", "description": "URL of the animated video cover (dynamic thumbnail)", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=viRTL670KOEGmIDnZHyCUweAItU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "encodeUserTag": { "type": "string", "description": "Optional encoded tag associated with the uploader", "example": "" }, "encodedType": { "type": "string", "description": "Encoding type used for the video", "example": "normal" }, "format": { "type": "string", "description": "Video container format", "example": "mp4" }, "height": { "type": "number", "description": "Video height in pixels", "example": 1280 }, "id": { "type": "string", "description": "Video ID", "example": "7572198435487501598" }, "originCover": { "type": "string", "description": "URL of the original (unprocessed) video thumbnail", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0uA2OkfQVp0iiA8I0mAI25BAi7CqsAQpVicIZ~tplv-tiktokx-origin.image?dr=14575&x-expires=1764266400&x-signature=Vz7GHSAB2W6toNyhhLqHqgJqagQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my" }, "playAddr": { "type": "string", "description": "URL restricted to TikTok servers.\nTo access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video)", "example": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oYqVJyAFfAQbapAygDRpgpBA2EEVFEfdSdrIQ5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2374&bt=1187&cs=0&ds=3&ft=3.u4FZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=0&rc=Ojc1ZWczPDhpOmZnOmVlZkBpM3NubnY5cmx3NzMzaTczNEAwYy9hLl4zXl4xNjBgMmI2YSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&btag=e00090000&expire=1764267687&l=2025112602185683E0DD5066ADFDA51BEC&ply_type=2&policy=2&signature=8cf407356d50899de3569d4f963b44c9&tk=tt_chain_token" }, "ratio": { "type": "string", "description": "Video resolution ratio label", "example": "720p" }, "size": { "type": "number", "description": "Video file size in bytes", "example": 23052674 }, "subtitleInfos": { "type": "array", "items": { "type": "object", "properties": { "Format": { "type": "string", "description": "Subtitle file format", "example": "webvtt" }, "LanguageCodeName": { "type": "string", "description": "IETF language code representing the subtitle language", "example": "gle-IE" }, "LanguageID": { "type": "string", "description": "Internal language identifier used by TikTok", "example": "24" }, "Size": { "type": "number", "description": "File size of the subtitle in bytes", "example": 3601 }, "Source": { "type": "string", "description": "Indicates the source of the subtitle (MT for machine translation)", "example": "MT" }, "Url": { "type": "string", "description": "Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers", "example": "https://v16-webapp.tiktok.com/e6516c847a90ebff2ce5a2d7380e8568/692896a7/video/tos/maliva/tos-maliva-v-0068c799-us/1f90242eb922461d86c37fb6d95b99b8/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=9716&bt=4858&ds=4&ft=3JYlmZmo0PD6_o5faQ9bn1AOhKkV1PCwqYlc&mime_type=video_mp4&qs=13&rc=M3NubnY5cmx3NzMzaTczNEBpM3NubnY5cmx3NzMzaTczNEAtcS9oMmRjaF5hLS1kMTJzYSMtcS9oMmRjaF5hLS1kMTJzcw%3D%3D&l=2025112602185683E0DD5066ADFDA51BEC&btag=e00050000" }, "UrlExpire": { "type": "number", "description": "Unix timestamp (in seconds) indicating when the subtitle URL expires", "example": 1764267687 }, "Version": { "type": "string", "description": "Version number of the subtitle track", "example": "4" } } } }, "videoID": { "type": "string", "description": "Internal video identifier used by TikTok", "example": "v15044gf0000d4atkifog65skk2ktp00" }, "videoQuality": { "type": "string", "description": "Video quality category assigned by TikTok", "example": "normal" }, "volumeInfo": { "type": "object", "properties": { "Loudness": { "type": "number", "description": "Measured loudness level of the audio track", "example": -20.4 }, "Peak": { "type": "number", "description": "Peak volume value detected in the audio", "example": 0.43652 } } }, "width": { "type": "number", "description": "Video width in pixels", "example": 720 }, "zoomCover": { "type": "object", "properties": { "240": { "type": "string", "description": "240×240 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:240:240.avif?dr=14555&x-expires=1764266400&x-signature=BanZKOImKVnik0EICH3eRM9%2F208%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "480": { "type": "string", "description": "480×480 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:480:480.avif?dr=14555&x-expires=1764266400&x-signature=QVjVHBEo4JFJevXtCTeBadYOZhs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "720": { "type": "string", "description": "720×720 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:720:720.avif?dr=14555&x-expires=1764266400&x-signature=pBUntIlezCX8Aif7fMc5D7RTxos%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" }, "960": { "type": "string", "description": "960×960 zoom-cropped cover image", "example": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oENrjSAlKABIItfDIAQAOyTeRUFArLIGA8qEe7~tplv-photomode-zoomcover:960:960.avif?dr=14555&x-expires=1764266400&x-signature=5d3SdFPlHe%2FIVw1MJju8xm%2BfeGo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my&ftpl=1" } } } } } } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Bad request" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info." } } } } } }, "403": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You are not subscribed to this API." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request failed with status 500: Internal Server Error" }, "status_code": { "type": "number", "example": 500 } } } } } } }, "operationId": "getApiCollectionPosts", "tags": [ "Collection" ], "parameters": [ { "in": "query", "name": "collectionId", "schema": { "type": "string", "pattern": "^\\d+$", "description": "Collection ID", "example": "7442134949027351314" }, "required": true }, { "in": "query", "name": "count", "schema": { "type": "integer", "exclusiveMinimum": 0, "default": 30, "description": "The number of results to be returned. The default and maximum value is 30", "example": 30 }, "required": false }, { "in": "query", "name": "cursor", "schema": { "type": "string", "description": "cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request", "default": "0" }, "required": false } ], "summary": "Get Collection Posts", "description": "Get Collection Posts", "security": [ { "apiKeyAuth": [] } ] } } } }