同事给了一批 TikTok 链接,怎么先整理目标,避免重复查同一条视频?
在发起任何付费调用之前,先在本地按字符串视频 ID 为 TikTok 链接去重。tiktok.app.v3.fetch_video_comments 的 aweme_id 只接受标准 /@账号/video/作品ID 链接中 /video/ 后的数字字符串,不接受整条 URL 或未解析短链。两条链接指向同一 aweme_id 时,只准备一条评论首页请求并保留两条来源;下面的 tiktok_ids.py 会在本地生成 requests.json 和 audit.json。
先对收到的链接分类
视频 ID(aweme_id)不是账号名、展示名、作者标识,也不是父评论 ID。读取一级评论使用 aweme_id;展开单条评论的回复线程时,还需要真实的父评论 ID。
执行前先检查本地准备结果
tiktok_ids.py 在本地生成两个文件:
requests.json: 一组未执行的独立首页请求体,不是批量 API 调用。audit.json: 记录去重后的唯一目标、重复输入和被拒绝的输入。
批准实际付费请求数之前,先检查 audit.json 中是否存在错误目标、空计划或未解析短链。生成 requests.json 和 audit.json 不产生费用,也不验证视频是否存在;所有输入均被拒绝时,表示没有任何目标被采集。ID 必须始终按字符串保存,已被表格软件或 JSON 数字解析舍入的 ID 转回字符串后无法恢复丢失的位数。
已有标准链接且只需要评论时,直接从链接提取 aweme_id。需要文案和互动指标时,复用已保存的视频详情,或按视频表现核查操作,不要为同一视频走两条详情查询路线。
将分享短链解析为可用 aweme_id
调用 tiktok.app.v3.fetch_one_video_by_share_url_v2,将完整分享链接传入 share_url。成功响应的作品列表位于 data.aweme_details,其中目标作品的 aweme_id 即为评论接口输入。注意区分作者字段:author.unique_id 是账号名,author.nickname 是展示名,author.sec_uid 是作者标识,三者均不是 aweme_id。
通过 tiktok.app.v3.fetch_one_video_by_share_url_v2 解析分享链接属于付费平台查询,不是本地字符串处理。手头已有标准 /video/ 链接且只需要评论时,直接本地提取 aweme_id 以省去详情调用;仅在需要标题、作者与互动指标快照时查询视频详情。收到响应后核对 status=succeeded;当 data.aweme_details 为空或返回多个候选时,先停下来核对来源,不要默认取第一条。
依据:data:tiktok.app.v3.fetch_one_video_by_share_url_v2 的输入合同和已观察到的输出。
在本地去重并生成评论请求清单
假设同事提供 20 条包含重复项和跟踪参数的标准 TikTok 视频链接,目标是每个唯一视频只准备一次评论首页请求,而不额外发起 20 次详情查询。把链接或原始字符串 ID 保存为 links.json 数组,不要用 JSON 数字保存 ID:
上述示例字符串用于演示接受与拒绝的输入形态,并非已验证存在的线上视频。将以下代码保存为 tiktok_ids.py 并运行 python3 tiktok_ids.py links.json prepared-comments。tiktok_ids.py 只接受正十进制字符串 ID 以及 HTTPS tiktok.com / www.tiktok.com 的 /@handle/video/ID 路径,其他链接形态都会记录为待显式解析。query 与 fragment 不会被当作 ID。tiktok_ids.py 不发起网络请求,保留原始输入,并拒绝覆盖已存在的输出目录。
发送前先审阅 audit.json。requests.json 包含多条独立的首页请求体,并非批量 API 调用;请仅在批准预算内逐条发送。按已记录的评论页参考单价(非实时价格)每次 $0.003 估算,20 个不同视频的首页合计 $0.060,重复链接已在本地合并。该估算不包含后续翻页、回复线程、分享链解析和模型分析,执行前请重新核价。requests 数组为空且输入全部被拒绝时,说明没有任何目标进入采集队列。
一级评论与回复线程的参数边界
tiktok_ids.py 不会从 vm/vt 短链、个人主页、photo 链接或非 TikTok 域名提取数字充当 ID。支持的分享短链需先走 tiktok.app.v3.fetch_one_video_by_share_url_v2 流程或获取最终 /video/ 页面 URL,再将 tiktok_ids.py 输出到新目录重新运行。不要将 query 参数数字、评论 ID、author.sec_uid 或账号名当作 aweme_id。语法校验通过不代表视频存在、公开或有评论,需以实际请求的响应状态为准。
一级评论动作(tiktok.app.v3.fetch_video_comments)使用 aweme_id,而回复线程动作(tiktok.app.v3.fetch_video_comment_replies)使用 item_id 加该线程的 comment_id,因此不能把 requests.json 原样套用到回复动作。本页仅覆盖目标标识准备,评论与回复输出字段需另行核对合同;当前公开的回复示例尚无填充 payload,不能据此假定响应字段。
合同与相关问题
执行请求前,免费检查对应合同:data:tiktok.app.v3.fetch_video_comments, data:tiktok.app.v3.fetch_video_comment_replies。

