先确认是哪一间直播的榜单
活动复盘需要查看送礼用户排行时，准备 room_id，rank_type 保持契约规定的默认值 30，无需修改。不要将用户标识当成房间编号；榜单时间范围以实际说明为准，不根据参数名推测。明确记录你查看的是哪个目标，有助于之后解释数据与直播场次的关系，而不是把多个场次混成一份总表。
名次只在对应榜单里有意义
读取结果后按实际提供的信息观察，不自行添加礼物金额、汇率或结算比例。榜单位置不能直接换成主播净收入，也不证明用户的真实财富或赠礼动机。假设某个账号位于前列，可以记录这个当次可见现象，但不能据此判断其与主播存在私人关系或业务合作。
给复盘留下可比较的条件
自己的记录可以包括房间来源、排行类型、读取时间和结果所覆盖的范围。若要比较两次活动，先检查条件是否一致；缺少可比依据时只描述各自观察，不硬算增长率。不要从榜单追踪或公开推测个人消费能力。最终材料用于说明直播互动中一个有限的公开侧面，实际收入仍需要合法取得的结算记录支持，运营判断也应结合活动目标，而不是只看谁排在最前面。
完整地址与参数
GET https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_live_gift_ranking
| 参数 | 类型 | 必填 | 含义 |
|---|---|---|---|
room_id |
string | 是 | 直播间room_id |
rank_type |
integer | 否 | 排行类型 |
可以复制的 Python 请求
安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。
import os
import requests
# 使用自己的 TRMesh 开发者密钥；不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_live_gift_ranking"
params = {
"room_id": "7356585666190461731"
}
response = requests.get(
url, params=params, timeout=30,
headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload) # 先核对真实响应，再提取业务字段
调用接口会使用你的 TRMesh 账号额度，运行前请确认接口价格。
