> ## 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 Live > Search Live ## OpenAPI ````yaml /api-reference/openapi.json get /api/search/live 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/live: get: tags: - Search summary: Search Live description: Search Live operationId: getApiSearchLive 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 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 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) ````