--- title: "Discover Posts by Keyword" method: GET path: "/api/post/discover" tags: ["Post"] --- # Discover Posts by Keyword `GET /api/post/discover` Discover Posts by Keyword ## Query parameters - `keyword` string, required — Keyword - `page` integer — Page ## Response `200` Success - object - `hasMore` boolean — Indicates whether there are more data available to fetch - `seoBizItemInfoList` object[] - `itemId` string - `customTdk` object - `article` string - `description` string - `keywords` string[] - `title` string - `videoList` object[] - `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 - `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 - `createTime` number — Unix timestamp indicating when the video was created - `desc` string — The text description of the video - `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 - `itemCommentStatus` number — The comment status of the video - `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 - `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 - `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 - `diversificationLabels` string[] ## 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/revisions/892e18b9f5af/schema)