--- title: "Search Video" method: GET path: "/api/search/video" tags: ["Search"] --- # Search Video `GET /api/search/video` Search Video ## Query parameters - `keyword` string, required — Search keyword - `cursor` integer — 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 - `search_id` string — 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 ## Response `200` Success - object - `hasMore` number — Indicates whether there are more data available to fetch - `cursor` number — Cursor for pagination. Use this value in subsequent requests to fetch more data - `log_pb` object - `impr_id` string — search_id to be used together with the cursor for pagination in subsequent requests to fetch more data - `item_list` object[] - `AIGCDescription` string — AI-generated description of the video, if available - `CategoryType` number — Indicates the video category type defined by TikTok - `author` object - `avatarLarger` string — URL of the user’s large-size avatar image - `avatarMedium` string — URL of the user’s medium-size avatar image - `avatarThumb` string — URL of the user’s thumbnail-size avatar image - `commentSetting` number — User’s comment privacy setting for their posts - `downloadSetting` number — User’s download permission setting for their videos - `duetSetting` number — User’s duet permission setting - `ftc` boolean — Indicates whether the account is subject to child safety restrictions - `id` string — User ID - `isADVirtual` boolean — Indicates whether the account is a virtual or advertisement related profile - `nickname` string — The user’s profile display name - `openFavorite` boolean — Whether the user’s liked videos list is public - `privateAccount` boolean — Indicates whether the account is set to private - `secUid` string — User secUid - `secret` boolean — Indicates whether the account is set to private - `signature` string — The user’s profile bio - `stitchSetting` number — User’s Stitch permission setting - `ttSeller` boolean — Indicates whether the user is registered as a TikTok Shop seller - `uniqueId` string — User uniqueID. The user’s public TikTok handle (username) - `verified` boolean — Indicates whether the account is officially verified - `UserStoryStatus` number — Status of the user’s story feature: - `0`: no story - `1`: active story Use the [**/api/user/story**](https://docs.tikfly.io/api-reference/user/get-user-story) endpoint to retrieve detailed user story information. - `authorStats` object — User stats - `diggCount` number — Total number of likes the user has given to other videos - `followerCount` number — Total number of users following this account - `followingCount` number — Number of accounts this user is following - `friendCount` number — Number of mutual followers (users that this account follows and who also follow back) - `heart` number — Total number of likes the user has received across all videos - `heartCount` number — Same as "heart". Represents the total number of likes the user has received - `videoCount` number — Total number of videos the user has posted - `authorStatsV2` object — An enhanced version of user stats where all metrics are exact values (not rounded) - `diggCount` string — Total number of likes the user has given to other videos - `followerCount` string — Total number of users following this account - `followingCount` string — Number of accounts this user is following - `friendCount` string — Number of mutual followers (users that this account follows and who also follow back) - `heart` string — Total number of likes the user has received across all videos - `heartCount` string — Same as "heart". Represents the total number of likes the user has received - `videoCount` string — Total number of videos the user has posted - `backendSourceEventTracking` string — Internal backend event tracking identifier used by TikTok - `challenges` object[] - `coverLarger` string — URL of the large cover image for the challenge - `coverMedium` string — URL of the medium cover image for the challenge - `coverThumb` string — URL of the thumbnail cover image for the challenge - `desc` string — Description of the challenge - `id` string — Challenge ID - `profileLarger` string — URL of the large profile image associated with the challenge, if any - `profileMedium` string — URL of the medium profile image associated with the challenge, if any - `profileThumb` string — URL of the thumnail profile image associated with the challenge, if any - `title` string — Title or name of the challenge - `contents` object[] - `desc` string — The text description of the video - `textExtra` object[] - `awemeId` string — ID of the referenced video, if the text mentions another TikTok video - `end` number — Ending character index of the detected entity within the text - `hashtagName` string — Hashtag detected in the text without the # symbol - `isCommerce` boolean — Indicates whether the detected entity is related to a commerce or promotional tag - `secUid` string — secUid of the referenced user - `start` number — Starting character index of the detected entity within the text - `subType` number — Subtype identifier for more specific classification of the entity - `type` number — Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference) - `userId` string — User ID of the referenced user, if the text includes a mention - `userUniqueId` string — Unique username of the referenced user - `createTime` number — Unix timestamp indicating when the video was created - `creatorAIComment` object - `eligibleVideo` boolean — Indicates whether the video is eligible for AI-powered comments - `hasAITopic` boolean — Indicates whether the video contains AI-generated topics - `notEligibleReason` number — Reason code explaining why the video is not eligible for AI comments - `desc` string — The text description of the video - `diversificationId` number — Identifier used by TikTok to diversify video distribution - `duetDisplay` number — Indicates duet visibility settings for this video - `duetEnabled` boolean — Indicates whether duets are allowed for this video - `forFriend` boolean — Indicates whether the video is shared only with friends - `id` string — Video ID - `isAd` boolean — Indicates whether the video is an advertisement - `isReviewing` boolean — Indicates whether the video is still under TikTok review - `itemCommentStatus` number — The comment status of the video - `item_control` object - `can_repost` boolean — Indicates whether the video can be reposted by users - `music` object - `album` string — Name of the album this music belongs to, if applicable - `authorName` string — Name of the music author or artist - `coverLarge` string — URL of the large-size cover image for the music - `coverMedium` string — URL of the medium-size cover image for the music - `coverThumb` string — URL of the thumbnail-size cover image for the music - `duration` number — Duration of the music in seconds - `id` string — Music ID - `isCopyrighted` boolean — Indicates whether the music is copyrighted - `original` boolean — Indicates whether this is an original sound created by the user - `playUrl` string — Direct URL to play or download the music - `private` boolean — Indicates whether the music is private and not publicly accessible - `title` string — Title of the music track - `tt2dsp` object — Internal object for TikTok DSP (digital service processing) data - `officalItem` boolean — Indicates whether the video is marked as official content - `originalItem` boolean — Indicates whether this is original content by the creator - `privateItem` boolean — Indicates whether the video is set to private - `secret` boolean — Indicates whether the video is set to private - `shareEnabled` boolean — Indicates whether sharing is enabled for this video - `stats` object - `collectCount` number — Number of times the post has been saved - `commentCount` number — Total number of comments on the post - `diggCount` number — Total number of likes the post has received - `playCount` number — Total number of views the post has generated - `shareCount` number — Number of times the post has been shared - `statsV2` object - `collectCount` string — Number of times the post has been saved - `commentCount` string — Total number of comments on the post - `diggCount` string — Total number of likes the post has received - `playCount` string — Total number of views the post has generated - `repostCount` string — Number of times the post has been reposted - `shareCount` string — Number of times the post has been shared - `stitchDisplay` number — Indicates stitch visibility settings for this video - `stitchEnabled` boolean — Indicates whether stitching is allowed for this video - `textExtra` object[] - `awemeId` string — ID of the referenced video, if the text mentions another TikTok video - `end` number — Ending character index of the detected entity within the text - `hashtagName` string — Hashtag detected in the text without the # symbol - `isCommerce` boolean — Indicates whether the detected entity is related to a commerce or promotional tag - `secUid` string — secUid of the referenced user - `start` number — Starting character index of the detected entity within the text - `subType` number — Subtype identifier for more specific classification of the entity - `type` number — Type identifier indicating the kind of text entity (e.g., hashtag, mention, video reference) - `userId` string — User ID of the referenced user, if the text includes a mention - `userUniqueId` string — Unique username of the referenced user - `textLanguage` string — Detected language of the caption text - `textTranslatable` boolean — Indicates whether the caption text can be translated - `video` object - `PlayAddrStruct` object - `DataSize` number — Size of the video file in bytes - `FileCs` string — File consistency signature used internally by TikTok - `FileHash` string — Hash value of the video file used for validation - `Height` number — Height of the video in pixels - `Uri` string — Internal TikTok URI reference for the video file - `UrlKey` string — Internal key used by TikTok CDN to map to the actual video file - `UrlList` string[] — URL restricted to TikTok servers. To access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video) - `Width` number — Width of the video in pixels - `VQScore` string — Video quality score calculated by TikTok - `bitrate` number — Average video bitrate in bits per second - `bitrateInfo` object[] - `Bitrate` number — Indicates the video bitrate in bits per second - `BitrateFPS` number — Frames per second associated with this bitrate - `CodecType` string — Video codec used for encoding - `Format` string — Video container or file format - `GearName` string — Name of the transcoding gear or quality profile - `MVMAF` string — Stringified MVMAF data containing multi-resolution video quality metrics - `PlayAddr` object - `DataSize` number — Size of the video file in bytes - `FileCs` string — File consistency signature used internally by TikTok - `FileHash` string — Hash value of the video file used for validation - `Height` number — Height of the video in pixels - `Uri` string — Internal TikTok URI reference for the video file - `UrlKey` string — Internal key used by TikTok CDN to map to the actual video file - `UrlList` string[] — URL restricted to TikTok servers. To access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video) - `Width` number — Width of the video in pixels - `QualityType` number — Internal quality type indicator used by TikTok - `VideoExtra` string — Stringified JSON containing additional transcoding metadata such as packet offsets, bitrate details, or quality scores - `claInfo` object - `enableAutoCaption` boolean — Indicates whether auto-generated captions are enabled - `hasOriginalAudio` boolean — Indicates whether the video contains original audio - `noCaptionReason` number — Reason code explaining why captions are unavailable - `codecType` string — Video codec used for encoding - `cover` string — URL of the primary video thumbnail - `definition` string — Human-readable video resolution label - `downloadAddr` string — URL restricted to TikTok servers. To access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video) - `duration` number — Video duration in seconds - `dynamicCover` string — URL of the animated video cover (dynamic thumbnail) - `encodeUserTag` string — Optional encoded tag associated with the uploader - `encodedType` string — Encoding type used for the video - `format` string — Video container format - `height` number — Video height in pixels - `id` string — Video ID - `originCover` string — URL of the original (unprocessed) video thumbnail - `playAddr` string — URL restricted to TikTok servers. To access or download the video use the [**Download endpoint**](https://docs.tikfly.io/api-reference/download/download-video) - `ratio` string — Video resolution ratio label - `size` number — Video file size in bytes - `subtitleInfos` object[] - `Format` string — Subtitle file format - `LanguageCodeName` string — IETF language code representing the subtitle language - `LanguageID` string — Internal language identifier used by TikTok - `Size` number — File size of the subtitle in bytes - `Source` string — Indicates the source of the subtitle (MT for machine translation) - `Url` string — Temporary URL to download the subtitle file. The URL is time-limited and may only be accessible from TikTok servers - `UrlExpire` number — Unix timestamp (in seconds) indicating when the subtitle URL expires - `Version` string — Version number of the subtitle track - `videoID` string — Internal video identifier used by TikTok - `videoQuality` string — Video quality category assigned by TikTok - `volumeInfo` object - `Loudness` number — Measured loudness level of the audio track - `Peak` number — Peak volume value detected in the audio - `width` number — Video width in pixels - `zoomCover` object - `240` string — 240×240 zoom-cropped cover image - `480` string — 480×480 zoom-cropped cover image - `720` string — 720×720 zoom-cropped cover image - `960` string — 960×960 zoom-cropped cover image ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Not Found - `500` — Internal Server Error --- [API](https://skmtc.net/tikfly/apis/tikfly-api-unoffical-tiktok-api.md) · [All operations](https://skmtc.net/tikfly/apis/tikfly-api-unoffical-tiktok-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tikfly/tikfly-api-unoffical-tiktok-api/versions/892e18b9f5af/schema)