Skip to main content
GET
/
api
/
v1
/
search
/
live
Search for live streams by keyword
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/search/live \
  --header 'x-rapidapi-key: <api-key>'
{
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2025-03-12T14:32:01.498Z",
    "cached": false,
    "version": "2025-01"
  },
  "data": [
    {
      "room_id": "7646869077847248000",
      "title": "hardcore minecraft + cape drop",
      "status": 2,
      "is_live": true,
      "viewer_count": 935,
      "cover_url": "https://p16-sign.tiktokcdn-us.com/...",
      "streamer": {
        "username": "royalreckers",
        "display_name": "Reckers",
        "avatar_url": "https://p16-sign.tiktokcdn-us.com/..."
      }
    }
  ],
  "pagination": {
    "cursor": "1778971238000",
    "has_more": true
  },
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns a paginated list of active live rooms matching the keyword. Results reflect real-time availability and may vary between requests.

Authorizations

x-rapidapi-key
string
header
required

Your RapidAPI subscription key. Injected automatically by the RapidAPI gateway in production.

Query Parameters

keyword
string
required

Search term. Also accepted as ?q=

cursor
string

Opaque base64 pagination token returned by the previous response. Encodes both the offset and the search session ID required by the upstream API.

Response

Success

meta
object

Response metadata present in every API response

data
object[]
pagination
object

Cursor-based pagination info

error
object

Error details. Present only when the request failed; null on success.