获取直播间首页推荐列表/Get live room homepage recommendation list

[中文]

用途:

• 获取直播间首页推荐列表

参数:

• related_live_tag: 相关直播标签(直播分类)。该参数的可选值不固定，请先调用 /fetch_live_recommend_tabs 接口获取当前可用的标签列表，再从中选取传入。

返回:

• 直播间首页推荐列表

备注:

• 不清楚 related_live_tag 可以传哪些值时，请调用 /fetch_live_recommend_tabs 接口获取当前可用的标签(分类 Tab)列表。
• 此接口返回的所有视频CDN链接均需要携带返回的 tt_chain_token 参数才能正常访问，否则会返回HTTP403错误。
• 在访问视频CDN链接时，请务必在请求头中携带 Cookie: tt_chain_token={tt_chain_token}，其中 {tt_chain_token} 替换为接口返回的 tt_chain_token 参数值。
• 如果访问视频CDN链接时返回HTTP 403错误:
  1. 请使用接口响应中以 https://www.tiktok.com/aweme/v1/play/ 开头的视频链接(通常在响应数据的 video.playAddr 或类似字段中)
  2. 在请求该链接时，务必在请求头中添加 Cookie: tt_chain_token={tt_chain_token}，其中 {tt_chain_token} 为接口返回的 tt_chain_token 参数值
  3. 示例请求头: Cookie: tt_chain_token=xxx
• 如果需要绕过此限制获取可以直接访问的无水印视频CDN链接，请使用 TikTok APP V3 目录下的接口。

[English]

Purpose:

• Get live room homepage recommendation list

Parameters:

• related_live_tag: Related live tag (live category). The available values are not fixed; call /fetch_live_recommend_tabs first to get the currently available tag list, then pick one to pass in.

Return:

• Live room homepage recommendation list

Note:

• If you are not sure which values related_live_tag accepts, call /fetch_live_recommend_tabs to get the currently available tag (category tab) list.
• All video CDN links returned by this interface need to carry the returned tt_chain_token parameter to be accessed normally, otherwise HTTP 403 error will be returned.
• When accessing the video CDN link, be sure to carry Cookie: tt_chain_token={tt_chain_token} in the request header, where {tt_chain_token} is replaced with the tt_chain_token parameter value returned by the interface.
• If you receive HTTP 403 error when accessing video CDN links:
  1. Use the video link starting with https://www.tiktok.com/aweme/v1/play/ from the API response (usually found in video.playAddr or similar fields)
  2. When requesting this link, make sure to add Cookie: tt_chain_token={tt_chain_token} in the request header, where {tt_chain_token} is the value returned by the API
  3. Example request header: Cookie: tt_chain_token=xxx
• If you need to bypass this restriction to get a watermark-free video CDN link that can be accessed directly, please use the interface under the TikTok APP V3 directory.

[示例/Example]

related_live_tag = "VALORANT"

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.