TikTok-Web-API

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

Changed on

[中文]

用途:

  • 获取直播间首页推荐的可用标签(直播分类 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 = ""

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)
  • Auth
    HTTP bearer

Query parameters

logidstring

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

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes