--- title: "Search Photo" method: GET path: "/api/search/photo" tags: ["Search"] --- # Search Photo `GET /api/search/photo` ## Request - Base URL: `https://tiktok-api23.p.rapidapi.com` - URL: `https://tiktok-api23.p.rapidapi.com/api/search/photo` - Auth: API key in header `x-rapidapi-key` Search Photo ## 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 - `has_more` 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[] - `id` string: Video ID - `desc` string: The text description of the video - `createTime` number: Unix timestamp indicating when the video was created - `video` object - `id` string: Video ID - `height` number: Video height in pixels - `width` number: Video width in pixels - `duration` number: Video duration in seconds - `ratio` string: Video resolution ratio label - `cover` string - `originCover` string: URL of the original (unprocessed) video thumbnail - `volumeInfo` object - `author` object - `id` string: User ID - `uniqueId` string: User uniqueID. The user’s public TikTok handle (username) - `nickname` string: The user’s profile display name - `avatarThumb` string: URL of the user’s thumbnail-size avatar image - `avatarMedium` string: URL of the user’s medium-size avatar image - `avatarLarger` string: URL of the user’s large-size avatar image - `signature` string: The user’s profile bio - `verified` boolean: Indicates whether the account is officially verified - `secUid` string: User secUid - `secret` boolean: Indicates whether the account is set to private - `ftc` boolean: Indicates whether the account is subject to child safety restrictions - `openFavorite` boolean: Whether the user’s liked videos list is public - `commentSetting` number: User’s comment privacy setting for their posts - `duetSetting` number: User’s duet permission setting - `stitchSetting` number: User’s Stitch permission setting - `privateAccount` boolean: Indicates whether the account is set to private - `isADVirtual` boolean: Indicates whether the account is a virtual or advertisement related profile - `downloadSetting` number: User’s download permission setting for their videos - `isEmbedBanned` boolean - `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 - `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 - `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 - `originalItem` boolean: Indicates whether this is original content by the creator - `officalItem` boolean: Indicates whether the video is marked as official content - `secret` boolean: Indicates whether the video is set to private - `forFriend` boolean: Indicates whether the video is shared only with friends - `itemCommentStatus` number: The comment status of the video - `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 - `privateItem` boolean: Indicates whether the video is set to private - `shareEnabled` boolean: Indicates whether sharing is enabled for this video - `isAd` boolean: Indicates whether the video is an advertisement - `duetDisplay` number: Indicates duet visibility settings for this video - `stitchDisplay` number: Indicates stitch visibility settings for this video - `imagePost` object - `images` object[] - `imageURL` object, required - `urlList` string[] - `imageHeight` number: Image height in pixels - `imageWidth` number: Image width in pixels - `cover` object - `imageURL` object, required - `urlList` string[] - `imageHeight` number: Image height in pixels - `imageWidth` number: Image width in pixels - `shareCover` object - `imageURL` object, required - `urlList` string[] - `imageHeight` number: Image height in pixels - `imageWidth` number: Image width in pixels - `title` string - `item_control` object - `can_repost` boolean: Indicates whether the video can be reposted by users - `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 - `AIGCDescription` string: AI-generated description of the video, if available - `CategoryType` number: Indicates the video category type defined by TikTok - `textLanguage` string: Detected language of the caption text - `textTranslatable` boolean: Indicates whether the caption text can be translated - `titleLanguage` string: Detected language of the title text - `titleTranslatable` boolean: Indicates whether the title text can be translated - `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 - `isReviewing` boolean: Indicates whether the video is still under TikTok review - `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 - `IsHDBitrate` boolean ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Not Found - `500`: Internal Server Error ## Changes - **2026-11-03** `095fffd2c728`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/changes/api/search/photo/get.md) --- [API](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api.md) - [All operations](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/revisions/095fffd2c728?raw)