Skip to main content
GET
/
api
/
v1
/
live
/
streams
Get live streams by tag
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/live/streams \
  --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": "7646845414508153620",
      "title": "mm2 and chill",
      "is_live": true,
      "viewer_count": 40,
      "like_count": 1200,
      "cover_url": "https://p16-sign.tiktokcdn-us.com/...",
      "snapshot_url": null,
      "category": "Roblox",
      "game_tag": "Roblox",
      "stream_urls": null,
      "total_viewers": 214,
      "shares": 3,
      "comments": 47,
      "streamer": {
        "username": "royalreckers",
        "display_name": "Reckers",
        "avatar_url": "https://p16-sign.tiktokcdn-us.com/...",
        "followers": 48200
      }
    }
  ],
  "pagination": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns active live stream rooms associated with the given tag. Results are real-time and will vary. Stream URLs (HLS/FLV) are included when available.

Authorizations

x-rapidapi-key
string
header
required

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

Query Parameters

tag
string
required

Tag/topic to filter live streams by (e.g. gaming, fitness, music)

Response

Success

meta
object

Response metadata present in every API response

data
object[]
pagination
object

Always null; this endpoint returns a single object and does not paginate.

Example:

null

error
object

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