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

> aweme_id 是抖音给每条视频和图文作品的 19 位数字 ID；modal_id 是网页链接里的参数，值就是同一个数字。长什么样、容易混的 ID，以及接口怎么用。

网页版：https://okdata.online/zh/answers/douyin-aweme-id-modal-id/

**简短回答：**它们是同一个数字。aweme_id 是抖音作品的 ID，一个 19 位整数；modal_id 是 douyin.com 在别的页面上弹层打开作品时用的参数，值就是 aweme_id。把数字作为 id、或把整条链接作为 url 传给 okdata 的抖音视频详情，每次 $0.002；搜索结果里的每条作品也以 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](/zh/answers/douyin-sec-uid/)。
- **数字 uid** 和**抖音号**也都是账号标识。
- **v.douyin.com 短链里的那串字符**不是 ID，跳转之后才有意义。

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

## 接口怎么收、怎么返回

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

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

## 示例

```bash
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](/zh/answers/douyin-share-link-to-video-id/)。

## 用到的接口

- [抖音视频详情](https://okdata.online/zh/apis/douyin/videos/get/) `douyin.videos.get`：$0.002/次
- [抖音视频搜索](https://okdata.online/zh/apis/douyin/videos/search/) `douyin.videos.search`：$0.02/次 · 每页约 20 条视频

## 更多抖音内容

- [抖音 API](https://okdata.online/zh/apis/douyin/)
- [抖音 API Python 教程：搜索、视频、账号和评论（2026）](https://okdata.online/zh/guides/douyin-api-python/)
- [怎么批量导出抖音视频评论](https://okdata.online/zh/guides/douyin-video-comments/)
- [怎么在抖音星图按条件找达人并拿到报价单](https://okdata.online/zh/guides/douyin-xingtu-creator-rates/)
- [抖音的 a_bogus 参数是什么？要拿抖音数据一定得自己生成吗？](https://okdata.online/zh/answers/douyin-a-bogus-signature/)
- [怎么导出抖音视频评论做情感分析？](https://okdata.online/zh/answers/douyin-export-comments-sentiment/)
- [怎么监控抖音上的品牌提及，每天拿到新发布的视频？](https://okdata.online/zh/answers/douyin-keyword-monitoring/)
- [为什么有些抖音链接是 /note/ 而不是 /video/？](https://okdata.online/zh/answers/douyin-note-vs-video-links/)
- [抖音爬虫的签名又失效了，是继续修还是换数据接口？](https://okdata.online/zh/answers/douyin-scraper-broke-signature/)
- [抖音评论采集用什么？官方接口、第三方 API、开源爬虫、采集工具 4 类方案怎么选（2026）](https://okdata.online/zh/compare/douyin-comment-scraping/)
- [抖音数据接口有哪些？官方开放平台、第三方 API、开源爬虫 4 类方案怎么选（2026）](https://okdata.online/zh/compare/douyin-data-apis/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [自己爬还是按次调用数据接口：成本、维护和风险](https://okdata.online/zh/compare/scraping-vs-data-api/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)

## 资料来源

- [Douyin /user/self link with modal_id reported as unsupported (VidBee issue #502)](https://github.com/nexmoe/VidBee/issues/502) (读取于 2026-11-12)
- [Search page link with ?modal_id= not recognised (TikTokDownloader issue #147)](https://github.com/JoeanAmier/TikTokDownloader/issues/147) (读取于 2026-11-12)
- [Excel specifications and limits: number precision of 15 digits](https://support.microsoft.com/en-us/office/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://github.com/nexmoe/VidBee/issues/502
- https://github.com/JoeanAmier/TikTokDownloader/issues/147

更新于 2026-11-12