获取直播间礼物列表/Get live room gift list

[中文]

用途:

• 获取直播间礼物列表
• room_id为可选参数，不传则获取通用礼物列表（2025年08月15日统计是256种礼物）

参数:

• room_id: 直播间ID（可选）

返回:

• 直播间礼物列表数据

备注:

• 此接口返回的所有视频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 gift list
• room_id is optional parameter, if not provided, will get general gift list (as of August 15, 2025, there are 256 types of gifts)

Parameters:

• room_id: Live room ID (optional)

Return:

• Live room gift list data

Note:

• 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]

room_id = "7381444193462078214" # 可选/Optional

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