朋友发来一条探店视频,你想整理周末候选餐厅,却不确定视频提到的门店是否就是准备去的分店。先查这条作品,再看是否需要位置或商家相关信息,能避免把几个同名门店混在一起。
作品 ID 与门店名称不是一回事
该接口要求 aweme_id。先从明确的作品来源准备 ID,保留原始链接,不要拿作者 ID 或店名代替。先处理一条视频,查看返回是否对应目标内容。餐厅名称和分店判断仍应结合原视频及其他可靠信息人工核对;作品详情并不等于门店营业信息服务。
需要锚点时再打开选项
need_anchor_info 默认 false。文档说明,开启后可能提供位置、商家、商品橱窗等锚点信息,也可能增加响应时间。如果只是归档视频描述,保持默认值即可;确实需要核查作品关联的商家时再开启。锚点是作品关联信息,不保证一定存在,也不能据此确认今天的营业时间、排队情况或菜品库存。
看见 HTTP 200 也要继续检查内容
这个接口有一个容易漏掉的约定:已删除、权限受限等不可用作品仍可能返回 HTTP 200,保留 filter_detail,并正常计费。因此不能仅凭 HTTP 状态就把一行记录标为“资料齐全”。检查业务结果与不可用说明,分别记录成功取得内容和未取得内容的情况。对不可用结果连续重复请求,不会自动解决权限或删除问题。
给出可核对的候选餐厅备注
自己的清单可以有“作品来源、查询时间、是否请求锚点、可见商家线索、待确认分店、查询结果”这些列。比如备注“视频涉及某分店,营业时间另查”,比写成“已验证可到店”准确。遇到错误且启用了锚点,可按文档尝试关闭该选项排查,但要说明此次少了哪类信息。最后得到的是可继续核实的探店线索,不是已经确认的行程安排。
完整地址与参数
GET https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_one_video
| 参数 | 类型 | 必填 | 含义 |
|---|---|---|---|
aweme_id |
string | 是 | 作品id |
need_anchor_info |
boolean | 否 | 是否需要锚点信息 |
可以复制的 Python 请求
安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。
import os
import requests
# 使用自己的 TRMesh 开发者密钥;不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_one_video"
params = {
"aweme_id": "7372484719365098803",
"need_anchor_info": "false"
}
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 账号额度,运行前请确认接口价格。
