---
title: "获取直播间首页推荐可用标签/Get available tags for live room homepage recommendation"
method: GET
path: "/api/v1/tiktok/web/fetch_live_recommend_tabs"
tags: ["TikTok-Web-API"]
---

# 获取直播间首页推荐可用标签/Get available tags for live room homepage recommendation

`GET /api/v1/tiktok/web/fetch_live_recommend_tabs`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/tiktok/web/fetch_live_recommend_tabs`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取直播间首页推荐的可用标签(直播分类 Tab)列表
- 用于配合 `/fetch_live_recommend` 接口，获取其 `related_live_tag` 参数的可选值
### 参数:
- logid: 翻页游标。首页请求时留空；加载下一页时，传入上一次响应返回的 `logid` 值
### 返回:
- 可用标签(直播分类 Tab)列表
- logid: 本次请求的日志ID(来自响应头 `x-tt-logid`)，翻页加载更多时需把它再次作为 `logid` 参数传入
### 备注:
- `related_live_tag` 的可选值并不固定，会随地区/时间变化，建议每次使用前实时获取。
### 翻页说明:
1. 首次请求 `logid` 留空，从返回结果中取出本次的 `logid`。
2. 加载下一页时，把上一次返回的 `logid` 再作为入参 `logid` 传入即可(内部会自动转换为 TikTok 的 req_id)。

# [English]
### Purpose:
- Get the available tag (live category tab) list for live room homepage recommendation
- Works together with `/fetch_live_recommend` to discover the available values of its `related_live_tag` parameter
### Parameters:
- logid: Pagination cursor. Leave empty for the first page; to load the next page, pass the `logid` value returned by the previous response
### Return:
- Available tag (live category tab) list
- logid: The log id of this request (from the `x-tt-logid` response header); pass it back as `logid` to load more
### Note:
- The available values of `related_live_tag` are not fixed and may change by region/time, so it is recommended to fetch them in real time before use.
### Pagination:
1. For the first request leave `logid` empty, and read the returned `logid` from the result.
2. To load the next page, pass the previous `logid` back as the `logid` parameter (internally converted to TikTok's req_id).

# [示例/Example]
logid = ""

## Query parameters

- `logid` string: 翻页游标，首页请求留空；加载更多时传入上一次响应返回的 logid/Pagination cursor, leave empty for the first page; pass the `logid` from the previous response to load more

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/web/fetch_live_recommend_tabs/get.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)