只有抖音分享链接,怎样确认这条作品并继续读评论?
用作品的 aweme_id 查抖音评论。 手里是 v.douyin.com 分享短链接时,先用 douyin.app.v3.fetch_one_video_by_share_url 取作品详情,核对文案和作者,再从 data.aweme_detail.aweme_id 取作品编号。网页里的 modal_id 只是信息流或主页里当前打开作品的线索,要用实际详情核对。
例如同事发来一条收纳产品演示,先核对视频文案和作者,再用作品 ID 查安装相关的评论。已保存的详情还能用来核对发布时间和互动数据。
你拿到的信息指向什么?
同一链接同时指向两个不同作品时,先确认目标作品再取数,不在两个 ID 里默选一个。
例如同时存了一条博主主页和从主页点开的作品:主页路径放在账号来源列,作品的 modal_id 放在候选作品列。拿到详情后,按实际返回的 aweme_id 确认是哪一条作品,再用确认后的 aweme_id 读评论。
从分享链接接到评论,怎样做?
- 把
share_url传给data:douyin.app.v3.fetch_one_video_by_share_url取得详情,保存方式见分享链接流程。 - 对照作品和作者,保留
data.aweme_detail.aweme_id的原始字符串。详情不可用时,保留原响应排查。 - 用确认后的作品 ID 准备
data:douyin.app.v3.fetch_video_comments的首页请求。已有核实过的 ID 时跳过第 1 步;已有保存的详情时直接复用。
把任务交给已接入 BeatAPI 工具的助手时,可以这样写:
确认这条分享链接对应的作品,记录文案、作者和原始作品ID,再准备评论读取。只从实际评论中整理安装步骤的疑问,保留原句和上下文,先告诉我本次取得的范围。
下面的本地脚本 prepare_comments.py 把已保存的详情转成一页评论请求。生成请求文件不等于已经取到评论;取得评论后的研究按评论指南继续。
把已保存详情转成评论首页请求
把下面的代码保存为 prepare_comments.py,运行 python3 prepare_comments.py douyin-detail.json douyin-comment-1。prepare_comments.py 只做本地转换,不联网,只创建新目录。脚本核对动作、成功状态、请求编号和原始字符串作品 ID,保留原文字节,输出可直接发送的 JSON 和来源哈希。
发送前,对照打印的 ID、已存详情和目标作品。本地哈希用来发现已存文件是否变化,不能证明短链解析到了正确作品。脚本拒绝数字类型的 JSON ID:即使 Python 能表示这个数,之前的数值转换也可能已经丢失精度,补位或转字符串都修复不了。
什么时候发送,花多少钱?
详情和评论分别计费,当前单价见价格页。需要解析分享链接时算一次详情请求,再加上选定的评论页数;已有可用 ID 或详情就复用。本地准备不产生新的查询。
确认目标和预算后,将生成的文件发送一次:
发送命令只执行一次:不要重复执行覆盖同一响应文件,出错后也不要自动重试。请求按 douyin.app.v3.fetch_video_comments 的输入合同固定 count=20、cursor=0;这一步只准备一页,不等于全量导出。当前合同没有公布评论输出结构,所以这一步交付的是请求文件,不是评论 CSV 或完整回复集。评论流程的下一步必须按保存结果的实际结构进行。
HTTP 成功但没有 aweme_detail 怎么办?
prepare_comments.py 在生成请求前停止。即使 HTTP 返回成功,分享详情响应也可能返回 data.filter_list 而不是 aweme_detail。保留原响应和 request_id;不要拿空 ID 查评论、改用作者 ID,或生成零互动记录。HTTP 成功不代表拿到了可用的作品详情。
prepare_comments.py 在本地按已公开的 douyin.app.v3.fetch_one_video_by_share_url 详情输出合同校验已保存响应。
浏览器里的 a_bogus / X-Bogus 需要一起传吗?
不需要。查抖音作品时传公开的 share_url;查评论时传已核对的 aweme_id、count 和 cursor。两次请求都用你的 BeatAPI Key 鉴权,抖音网页签名和 Cookie 留在原客户端。
a_bogus 和 X-Bogus 是旧工具日志里常见的网页请求签名,MediaCrawler 和 f2 展示了两个开源项目各自对 a_bogus 和 X-Bogus 的用法。从旧工具迁移任务时,先找回旧请求对应作品的公开链接,再按下列步骤准备请求。MediaCrawler 客户端 · f2 抖音工具
从一段浏览器请求迁移到本页流程
- 先确认需要的是哪篇作品,不复制浏览器的内部 API URL。有公开分享链接就走详情;已有核实过的
aweme_id时,直接准备评论请求。 - 按「详情 → 原字符串
aweme_id→ 评论 JSON」的交接保留来源。签名、Cookie、作者 ID 和 API Key 都不能充当aweme_id。 - 只传所选动作合同列出的输入。不要为了模仿浏览器添加 User-Agent 指纹、会话数据或未声明的参数;额外参数不保证在扣费前被拒绝。
- 请求失败时,先看 HTTP 状态、公开错误码和
request_id,不把所有错误都解释成签名过期。
share_url 与 aweme_id 等公开输入不保证能取到私密、已删除或不可访问的作品,第三方网页算法也可能变化。开源项目行为说明来自上方链接的公开源码与已公开的 BeatAPI 动作合同。
msToken 是 BeatAPI Key、作品ID或翻页游标吗?
都不是。在 MediaCrawler 客户端里,网页请求的 msToken 参数取自浏览器 localStorage 的 xmst;f2 的 TokenManager 用另一套实现管理 msToken。MediaCrawler 与 f2 的处理方式仅反映开源代码实现,不是抖音官方公布的令牌寿命或请求要求。
本页的两个 BeatAPI 动作都没有 msToken 输入字段。douyin.app.v3.fetch_one_video_by_share_url 传公开的 share_url;douyin.app.v3.fetch_video_comments 传已核对的原始 aweme_id、count=20 和整数 cursor。BeatAPI Bearer Key 负责鉴权,aweme_id 定位作品,cursor 定位评论页,三者不能互相替换。不要往请求或支持消息里追加 msToken、xmst、整份浏览器存储或抖音 Cookie。
已有的浏览器工具报令牌问题时,单独诊断浏览器工具的会话。旧工具的令牌问题不证明 aweme_id 错误,刷新抖音网页令牌也修复不了 BeatAPI 的 invalid_api_key 或余额不足。把任务迁到 BeatAPI 动作,就是按动作公布的输入传参,不是移植旧浏览器状态;上方签名与错误表按具体场景分开处理。换请求路径不能让需要登录才能看或不可访问的作品变得可取。
支持排查记录保留 action、HTTP 状态、error.code、request_id 和采集时间;分享前删去 Authorization、Cookie、带令牌的查询串和无关响应内容。首页按合同用 cursor=0,后续页的 cursor 取自 douyin.app.v3.fetch_video_comments 上一页的实际响应;不要拿 msToken 当游标,也不要套用别家一小时的游标寿命。
ttwid 是达人编号吗?需要从浏览器复制给 BeatAPI 吗?
不是,也不需要。在 f2 抖音实现里,TokenManager.gen_ttwid 从响应 Cookie 读取 ttwid,缺少该 Cookie 时抛出错误。f2 的实现仅说明该项目如何处理 ttwid,不是抖音对所有接口的官方规范,没有给出统一有效期,也不能证明 ttwid 代表一个登录用户。不要把 ttwid 填进 aweme_id、sec_uid 或 BeatAPI 的 Authorization。
本页的两个 BeatAPI 动作都没有浏览器 Cookie 或 ttwid 输入。按问题出现的位置排查:
Cookie 不是密码,但也不要公开整段 Cookie:完整 Cookie 头可能含有无关的登录与会话信息。分享链接与评论流程不需要 ttwid 生成器或到期刷新任务;其他 BeatAPI 动作可能声明不同的输入。
verifyFp、fp、s_v_web_id 总是同一个值吗?
不总是。在 MediaCrawler 详情请求代码里,Cookie 中的 s_v_web_id 被同时赋给 verifyFp 和 fp 请求参数。在 f2 实现里,gen_s_v_web_id 复用 gen_verify_fp 的生成方法。复用同一生成方法,不等于独立调用两次会得到相同的值;MediaCrawler 与 f2 也都不是抖音请求的官方协议或统一有效期说明。
verifyFp、fp 和 s_v_web_id 属于浏览器请求和会话信息,不是作品 ID、达人 ID,也不能证明某个人通过了验证。douyin.app.v3.fetch_one_video_by_share_url 与 douyin.app.v3.fetch_video_comments 都不接收 verifyFp、fp 或 s_v_web_id。按公开分享链接或已核对 aweme_id 流程操作,不把 Cookie 集合、指纹信息或浏览器内部 URL 迁进公开数据请求。
旧工具出现浏览器安全错误时,单独记录是哪个工具、哪类请求失败;不要直接推断为 BeatAPI Key 有误、视频已删除或采集成功但零结果。真正的 BeatAPI 错误按上面的 HTTP 状态、错误码和请求编号表排查。生成指纹和循环重试都不是文档规定的修复方法;本页流程不生成指纹,也不绕过验证。

