# What are aweme_id and modal_id on Douyin, and what is a v.douyin.com link?

aweme_id is a Douyin post's ID, a long string of digits. modal_id is the same ID in a web address when a video opens over a feed, a search or a profile. A v.douyin.com link is the app's short link. DataXAPI's video endpoints take the ID as id, or any of these links as url. DataXAPI reads Douyin with 36 endpoints, from $0.0020 a call; a failed call is not charged.

## What each one is

A post's own page is `https://www.douyin.com/video/<aweme_id>`, or `/note/<aweme_id>` for an image post. As public open-source tools describe it, the ID is 19 digits and is to be kept as text, since it is beyond the integers JavaScript holds exactly. Made up, it looks like `1234567890123456789`.

When the website opens a video over the feed, a search or an account's page, the address keeps that page and adds `?modal_id=<aweme_id>`, as public open-source tools describe it and as DataXAPI has recorded.

What the app's share button copies is a share text with `https://v.douyin.com/<code>/` in it. The code is not the ID; opening the link shows which video or profile it leads to.

## What DataXAPI takes

`douyin.videos.get`, `douyin.videos.comments.list` and `douyin.videos.metrics` take the ID as `id`. As `url` they take, pasted as it is: the `/video/` or `/note/` link, a link with `modal_id`, the page a share opens on a phone (m.douyin.com or iesdouyin.com), a v.douyin.com link, or a whole share text with one of these in it.

A v.douyin.com link is opened once to see which video it leads to. A link that names two different posts, a post's page with another opened over it, is not taken.

## Endpoints

- [Douyin video detail](https://dataxapi.com/apis/douyin/videos/get/) ($0.0020 / a call): Get one Douyin video or image post by ID or link: caption, author, engagement counts, time posted.
- [Douyin video comments](https://dataxapi.com/apis/douyin/videos/comments/list/) ($0.0020 / a call): Get a page of comments on a Douyin video: text, commenter, likes, reply count, time posted.
- [Douyin video play count](https://dataxapi.com/apis/douyin/videos/metrics/) ($0.0020 / a call): Get a Douyin video's counts as of now, by its ID: plays and likes.

## How-to guides

- [How to export Douyin video comments in bulk](https://dataxapi.com/guides/douyin-video-comments/)

## Sources

What this page says of other services is from their own pages and documents, read on 2026-10-29. Prices and features change: check the source before you decide.

- [Douyin_TikTok_Download_API (open-source project): FAQ and glossary](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/documents/zh/17-faq.md)
- [MediaCrawler (open-source project): Douyin link forms](https://github.com/NanmiCoder/MediaCrawler/blob/main/media_platform/douyin/help.py#L101-L126)

## More about Douyin

- [Douyin API](https://dataxapi.com/apis/douyin/)
- [How do I export Douyin data?](https://dataxapi.com/answers/export-douyin-data/)
- [What is sec_uid on Douyin, and how is it different from uid and the Douyin ID?](https://dataxapi.com/answers/douyin-sec-uid/)
- [Is the Douyin search index a number of searches?](https://dataxapi.com/answers/douyin-search-index-vs-search-count/)
- [What is the Douyin keyword index (Ocean Engine)?](https://dataxapi.com/answers/what-is-douyin-keyword-index-ocean-engine/)
- [What is Douyin Xingtu?](https://dataxapi.com/answers/what-is-douyin-xingtu/)
- [How to get Douyin keyword trends in bulk](https://dataxapi.com/guides/douyin-keyword-trends/)
- [How to look up a Douyin creator's Xingtu rate card](https://dataxapi.com/guides/douyin-xingtu-creator-rates/)

---

Catalog revision 5c3194deef3264cc. [HTML version](https://dataxapi.com/answers/douyin-aweme-id-modal-id/)