Search TikTok Live

Search the live side of TikTok. A keyword returns the broadcasts currently matching it, along with the host account and the room details TikTok exposes for a running stream. Because live rooms open and close constantly this is an endpoint to poll rather than cache, and cursor with search_id lets you page through a busy term while the results are still current.

Try on Playground

PrimeApi Endpoints > Search Endpoints > Search Live

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/search-live?keyword={keyword}&cursor={cursor}&search_id={search_id}

Required Parameters

keyword

Optional Parameters

cursor, search_id

Request Examples

Request Flow

Search Live is a single GET call to /search-live, and keyword has to travel with it in the query string. cursor, search_id then shape what comes back. Swap YOUR_API_KEY for your own key and both snippets below run as they are.

Authentication

Header based. Send X-PrimeAPI-Key with every request — there is no OAuth handshake and no token to refresh.

Credits

One Search Live call costs 1 credit. Your remaining balance comes back on every response in the X-PrimeAPI-Balance header, so you can watch usage without a second lookup.

cURL

curl -X GET "https://api.primeapi.co/search-live?keyword=cat&cursor=0&search_id=0" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/search-live?keyword=cat&cursor=0&search_id=0"
headers = {"X-PrimeAPI-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)

print(response.json())
print("Credits left:", response.headers.get("X-PrimeAPI-Balance"))

Endpoint Response

Example URL

https://api.primeapi.co/search-live?keyword=cat&cursor=0&search_id=0

Content Type

JSON

Example Response

{
    "status_code": 0,
    "data": [
        {
            "live_info": {
                "raw_data": "{\"id\":7460983994278333216,\"id_str\":\"7460983994278333216\",\"status\":2,\"owner_user_id\":7396075823487484961,\"title\":\"Meow Manor cat sanctuary \ud83d\udc08\",\"user_count\":50,\"client_version\":380100,\"cover\":{\"url_list\":[\"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/48969b4c81c4f69d24f57c390241c376~c5_720x720.webp?lk3s=a5d48078\\u0026nonce=91752\\u0026refresh_token=efb314550b56ced415ebf924890a874d\\u0026x-expires=1737331200\\u0026x-signature=r8ZADB00QH3BuZGnSNSNgp6ulac%3D\\u0026shp=a5d48078\\u0026shcp=fdd36af4\",\"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/48969b4c81c4f69d24f57c390241c376~c5_720x720.jpeg?lk3s=a5d48078\\u0026nonce=27274\\u0026refresh_token=b7d4157adc2498e4f6076aa8991e2943\\u0026x-expires=1737331200\\u0026x-signature=iixCvtnW6LsoscAWEBCfEN%2Bwp6k%3D\\u0026shp=a5d48078\\u0026shcp=fdd36af4\"],\"uri\":\"720x720/tos-useast2a-avt-0068-euttp/48969b4c81c4f69d24f57c390241c376\"},\"stream_url\":{\"rtmp_pull_url\":\"https://pull-f5-tt03.tiktokcdn.com/stage/stream-3287112022535177085_or4.flv?expire=1738368836\\u0026session_id=044-20250118001354B659B1E817176642FAB3\\u0026sign=e9260ddb24d473fd0d88b4a72b00bf48\",\"flv_pull_url\":{\"FULL_HD1\":\"https://pull-f5-tt03.tiktokcdn.com/stage/stream-3287112022535177085_uhd.flv?expire=1738368836\\u0026sign=70ae3983c3592886664219198c7894ff\",\"HD1\":\"https://pull-f5-tt03.tiktokcdn.com/stage/stream-3287112022535177085_hd.flv?expire=1738368836\\u0026sign=da7c5552f0ac9f0d4531a4857e3b3487\",\"SD1\":\"https://pull-f5-tt03.tiktokcdn.com/stage/stream-3287112022535177085_ld.flv?expire=1738368836\\u0026sign=c05f1dc91115354eeb6329a92f7e3005\",\"SD2\":\"https://pull-f5-tt03.tiktokcdn.com/stage/stream-3287112022535177085_sd.flv?expire=1738368836\\u0026sign=cc06b030734ca7fa95a5e428b46fde08\"},\"candidate_resolution\":[\"SD1\",\"SD2\",\"HD1\",\"FULL_HD1\"],\"flv_pull_url_params\":{\"FULL_HD1\":\"{\\\"v_rtbitrate_timestamp\\\":1737158818074,\\\"stream_suffix\\\":\\\"uhd\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":1000000,\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":0,\\\"v_rtbitrate\\\":919700,\\\"v_rtpsnr\\\":0}\",\"HD1\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1000000,\\\"resolution\\\":\\\"540x960\\\",\\\"gop\\\":0}\",\"SD1\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":500000,\\\"resolution\\\":\\\"480x853\
  ... (truncated)

Show full response

Related Endpoints

More TikTok Search Endpoints

Search TikTok (Top Results) Search TikTok Videos Search TikTok Users Get TikTok Searched Suggest

View all Search Endpoints

Contact

You can contact us via Telegram or Gmail

@primeapi_co

Gmail

primeapico@gmail