抖音链接里的 aweme_id 和 modal_id 是什么？

抖音自己的接口把每条作品叫作 aweme，aweme_id 就是作品 ID：一个纯数字，近几年发的作品都是 19 位，比如 7428815302664207643。视频和图文用的是同一套编号。modal_id 并不是另一个 ID，而是 douyin.com 网页上的一个参数：在搜索结果、博主主页、自己的喜欢列表或精选页上点开一条作品，它会以弹层的方式盖在当前页面上，地址栏就多出 ?modal_id=，值就是 aweme_id。所以 douyin.com/search/露营?modal_id=7428815302664207643 和 douyin.com/video/7428815302664207643 指的是同一条作品。只认路径里 /video/ 的工具碰到前一种链接就会报“不支持的链接”，各个下载器的 issue 区里这类反馈一直没断过。

这个数字会出现在哪里

位置	例子	含义
视频页	douyin.com/video/7428815302664207643	路径里的 aweme_id
图文页	douyin.com/note/7428815302664207643	同一套编号，路径不同
别的页面上的弹层	douyin.com/user/MS4w...?modal_id=7428815302664207643	参数里的 aweme_id
分享短链	v.douyin.com/iAbCdEf/	短码，跳转后才变成上面某一种
okdata 返回	作品的 id	字符串形式的 aweme_id

容易混的几个 ID

• 评论 ID 也是 7 开头的 19 位数字。单独放一列，别跟作品 ID 搞混后关联错。
• sec_uid（MS4wLjABAAAA…）标识的是账号，不是作品，见怎么拿到 sec_uid。
• 数字 uid 和抖音号也都是账号标识。
• v.douyin.com 短链里的那串字符不是 ID，跳转之后才有意义。

还有一个特性：aweme_id 除以 2^32，得到的是一个接近作品上传时间的 Unix 时间戳。抖音没有公开说明过这一点，定时发布的作品上线时间也会晚好几个小时，所以报表里请用 published_at。

接口怎么收、怎么返回

抖音视频详情可以传 id=7428815302664207643，也可以用 url= 传上表里任意一种链接，带 modal_id 的链接和 v.douyin.com 短链都行。返回的作品带 id（字符串形式的 aweme_id）、url、type（video 或 image）、文案、发布时间、作者和各项数据。抖音视频搜索的每条结果都带同样的 id，视频评论也用它作为 id。

步骤	调用次数	费用
一条链接或 ID 换作品数据	1	$0.002
表格里的 300 条链接	300	$0.60
一页搜索结果，自带 ID	1	$0.02

示例

curl -G "https://api.okdata.online/v1/douyin/videos/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'url=https://www.douyin.com/search/露营?modal_id=7428815302664207643' \
  --data-urlencode 'fields=id,url,type,published_at,metrics.likes'

返回的 url 是规范链接：视频是 /video/，图文是 /note/。

限制

• ID 要按文本存。19 位数字超出了双精度浮点数能精确表示的范围：JavaScript 会把它四舍五入，Excel 只保留 15 位有效数字，后四位直接变成 0。
• 从登录后页面（比如 /user/self）复制的 modal_id 链接一样能用，因为只读取那个数字。
• 已删除或私密的作品返回 not_found，不扣费。
• 从整段分享文案里提取链接再换 ID 的完整步骤，见抖音分享链接转视频 ID。