> ## Documentation Index > Fetch the complete documentation index at: https://docs.tikfly.io/llms.txt > Use this file to discover all available pages before exploring further. # Search Photo > Search Photo ## OpenAPI ````yaml /api-reference/openapi.json get /api/search/photo 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 security: [] paths: /api/search/photo: get: tags: - Search summary: Search Photo description: Search Photo operationId: getApiSearchPhoto parameters: - in: query name: keyword schema: type: string minLength: 1 description: Search keyword example: fornite 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 responses: '200': description: Success content: application/json: schema: type: object properties: has_more: 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: 202608302053154476338C59B6F2D200DB item_list: type: array items: type: object properties: id: type: string description: Video ID example: '7665851293465906465' desc: type: string description: The text description of the video example: When did you start playing Fortnite? 💔😔 createTime: type: number description: Unix timestamp indicating when the video was created example: 1784845094 video: type: object properties: id: type: string description: Video ID example: '7665851293465906465' height: type: number description: Video height in pixels example: 0 width: type: number description: Video width in pixels example: 0 duration: type: number description: Video duration in seconds example: 0 ratio: type: string description: Video resolution ratio label example: '' cover: type: string description: '' example: >- https://p16-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=8xNyD0u1vc4b545W9QcD7IRKon4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 originCover: type: string description: >- URL of the original (unprocessed) video thumbnail example: >- https://p16-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=8xNyD0u1vc4b545W9QcD7IRKon4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 volumeInfo: type: object description: '' example: {} author: type: object properties: id: type: string description: User ID example: '6986045415510639621' uniqueId: type: string description: >- User uniqueID. The user’s public TikTok handle (username) example: _sweazyfn_ nickname: type: string description: The user’s profile display name example: sweazyfn avatarThumb: type: string description: URL of the user’s thumbnail-size avatar image example: >- https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/04da9cf30ab75be7027f40cf785c577b~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=84ab508f&x-expires=1788264000&x-signature=Ebbl9w5s5%2BeiL4HkNXaR0TkIVVg%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-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/04da9cf30ab75be7027f40cf785c577b~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=d99c1afa&x-expires=1788264000&x-signature=pBUlku7s1ybOcPyG1iudkXGX%2FkM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my avatarLarger: type: string description: URL of the user’s large-size avatar image example: >- https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/04da9cf30ab75be7027f40cf785c577b~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=d3dd624a&x-expires=1788264000&x-signature=BsmCi8KCcRYB%2FoUnep4Nh2uvs4E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my signature: type: string description: The user’s profile bio example: 224k 🤩❤️ verified: type: boolean description: >- Indicates whether the account is officially verified example: false secUid: type: string description: User secUid example: >- MS4wLjABAAAA_jHyugRY4QMsirtiPh52WSaegZD-zqEpJrWTJB0jPcngtn7t74EGvI-A7VaRNgKZ secret: type: boolean description: Indicates whether the account is set to private example: false ftc: type: boolean description: >- Indicates whether the account is subject to child safety restrictions example: false openFavorite: type: boolean description: Whether the user’s liked videos list is public example: false commentSetting: type: number description: User’s comment privacy setting for their posts example: 0 duetSetting: type: number description: User’s duet permission setting example: 0 stitchSetting: type: number description: User’s Stitch permission setting example: 0 privateAccount: type: boolean description: Indicates whether the account is set to private example: false isADVirtual: type: boolean description: >- Indicates whether the account is a virtual or advertisement related profile example: false downloadSetting: type: number description: >- User’s download permission setting for their videos example: 0 isEmbedBanned: type: boolean description: '' example: false 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 originalItem: type: boolean description: >- Indicates whether this is original content by the creator example: false officalItem: type: boolean description: >- Indicates whether the video is marked as official content example: false secret: type: boolean description: Indicates whether the video is set to private example: false forFriend: type: boolean description: >- Indicates whether the video is shared only with friends example: false itemCommentStatus: type: number description: The comment status of the video 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 privateItem: 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 isAd: type: boolean description: Indicates whether the video is an advertisement example: false duetDisplay: type: number description: Indicates duet visibility settings for this video example: 0 stitchDisplay: type: number description: Indicates stitch visibility settings for this video example: 0 imagePost: type: object properties: images: type: array items: type: object properties: imageURL: type: object properties: urlList: type: array items: type: string description: '' example: - >- https://p16-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=8xNyD0u1vc4b545W9QcD7IRKon4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 - >- https://p19-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=T9trVeg1%2BZQV1EXyXGX3xC3Sbvo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 imageHeight: type: number description: Image height in pixels example: 2080 imageWidth: type: number description: Image width in pixels example: 2080 required: - imageURL cover: type: object properties: imageURL: type: object properties: urlList: type: array items: type: string description: '' example: - >- https://p16-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=8xNyD0u1vc4b545W9QcD7IRKon4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 - >- https://p19-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=T9trVeg1%2BZQV1EXyXGX3xC3Sbvo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 imageHeight: type: number description: Image height in pixels example: 2080 imageWidth: type: number description: Image width in pixels example: 2080 required: - imageURL shareCover: type: object properties: imageURL: type: object properties: urlList: type: array items: type: string description: '' example: - >- https://p16-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=8xNyD0u1vc4b545W9QcD7IRKon4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 - >- https://p19-common-sign.tiktokcdn.com/tos-maliva-i-photomode-us/ade1d9b328b844459b9f1ce1b94ddad7~tplv-photomode-image.jpeg?dr=14555&x-expires=1788264000&x-signature=T9trVeg1%2BZQV1EXyXGX3xC3Sbvo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my&ftpl=1 imageHeight: type: number description: Image height in pixels example: 2080 imageWidth: type: number description: Image width in pixels example: 2080 required: - imageURL title: type: string description: '' example: '' item_control: type: object properties: can_repost: type: boolean description: >- Indicates whether the video can be reposted by users example: true 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' 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: 120 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 titleLanguage: type: string description: Detected language of the title text example: un titleTranslatable: type: boolean description: Indicates whether the title text can be translated example: false 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) isReviewing: type: boolean description: >- Indicates whether the video is still under TikTok review example: false 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 IsHDBitrate: type: boolean description: '' 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 security: - apiKeyAuth: [] 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) ````