Skip to main content
GET
/
api
/
v1
/
live
/
categories
Browse live stream categories
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/live/categories \
  --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": [
    {
      "name": "Gaming",
      "sub_categories": [
        {
          "name": "Minecraft",
          "cover_url": "https://p16-sign.tiktokcdn-us.com/...",
          "viewer_count": 27422
        }
      ]
    }
  ],
  "pagination": {
    "cursor": "1778971238000",
    "has_more": true
  },
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns a paginated list of top-level live browse categories, each containing sub-category tabs with viewer counts.

Authorizations

x-rapidapi-key
string
header
required

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

Query Parameters

count
integer
default:20

Number of categories to return (1–50)

Required range: 1 <= x <= 50
cursor
string

Pagination cursor from a previous response

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.