---
title: "Search Live"
method: GET
path: "/api/search/live"
tags: ["Search"]
---

# Search Live

`GET /api/search/live`

Search Live

## 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
  - `hasMore` 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
  - `data` object[]
    - `live_info` object
      - `raw_data` string — Raw JSON string containing full live metadata returned directly from TikTok
      - `room_info` object
        - `has_commerce_goods` boolean — Indicates whether the live room has commerce goods enabled
        - `is_battle` boolean — Indicates whether the live is currently in battle mode

## 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/versions/892e18b9f5af/schema)