Douyin Video API
Fetch a public Douyin video by share URL with normalized author and engagement data.
$1.20/1k req, pay per request, no subscription.
{"id": "7448118827402972455","caption": "张家界云海日出,这一趟没白爬 #张家界 #日出 #旅行vlog","createdUtc": 1757779800,"url": "https://www.douyin.com/video/7448118827402972455","image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_zhangjiajie_cover~tplv-dy-resize-origshort-autoq-75.jpeg","durationMs": 96000,"authorUserId": "37461829504736281","authorSecUserId": "MS4wLjABAAAA3QhBkXt5nJ2wYpLdM9RfCsV6zKq8Tn1oWhGxUcPbEa4iRj7VmDs0YfLqXnCwZk9T",... 13 more fields}
Pricing
Douyin Video API pricing
Try it
Get Douyin video in one request
This sample shows 23 of 24 fields. See every field
{
"found": true,
"data": {
"id": "7448118827402972455",
"caption": "张家界云海日出,这一趟没白爬 #张家界 #日出 #旅行vlog",
"createdUtc": 1757779800,
"url": "https://www.douyin.com/video/7448118827402972455",
"image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_zhangjiajie_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
"durationMs": 96000,
"authorUserId": "37461829504736281",
"authorSecUserId": "MS4wLjABAAAA3QhBkXt5nJ2wYpLdM9RfCsV6zKq8Tn1oWhGxUcPbEa4iRj7VmDs0YfLqXnCwZk9T",
"authorNickname": "远方的阿凯",
"views": 2740000,
"likes": 187000,
"comments": 6400,
"shares": 9800,
"saves": 33000,
"authorUniqueId": "akai_travels",
"authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_akai_avatar~c5_300x300.jpeg",
"authorVerified": true,
"region": "CN",
"videoUrl": "https://v3-web.douyinvod.com/example_token_j1k2l3/video/tos/cn/tos-cn-ve-15/exampleZhangjiajieVideoId/?a=6383&ch=0&cr=0&dr=0&lr=all&cd=0%7C0%7C0%7C3",
"width": 1080,
"height": 1920
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- urlstring
https://www.douyin.com/video/7448118827402972455
Public Douyin video share URL.
Response
JSON, one example value per field.
Normalized video, or null when not found.
- authorImagestring
https://p3-pc.douyinpic.com/img/aweme-avatar/example_akai_avatar~c5_300x300.jpeg
Author's avatar image URL.
- authorNicknamestring
远方的阿凯
Author display name. Populated whenever the provider has data for the entity.
- authorSecUserIdstring
MS4wLjABAAAA3QhBkXt5nJ2wYpLdM9RfCsV6zKq8Tn1oWhGxUcPbEa4iRj7VmDs0YfLqXnCwZk9T
Author sec_user_id. Populated whenever the provider has data for the entity.
- authorUniqueIdstring
akai_travels
Author's Douyin handle (unique id).
- authorUserIdstring
37461829504736281
Author user identifier. Populated whenever the provider has data for the entity.
- authorVerifiedboolean
true
Whether the author's account is verified.
- captionstring
张家界云海日出,这一趟没白爬 #张家界 #日出 #旅行vlog
Video caption. Populated whenever the provider has data for the entity.
- commentsinteger
6400
Comment count.
- createdUtcnumber
1757779800
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- durationMsinteger
96000
Video duration in milliseconds.
- heightinteger
1920
Pixel height of the video.
- idstring
7448118827402972455
Video identifier. Populated whenever the provider has data for the entity.
- imagestring
https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_zhangjiajie_cover~tplv-dy-resize-origshort-autoq-75.jpeg
Video cover image URL.
- likesinteger
187000
Like count.
- regionstring
CN
Two-letter region code the video was published from.
- savesinteger
33000
Save count.
- sharesinteger
9800
Share count.
- urlstring
https://www.douyin.com/video/7448118827402972455
Canonical Douyin video URL. Populated whenever the provider has data for the entity.
- videoUrlstring
https://v3-web.douyinvod.com/example_token_j1k2l3/video/tos/cn/tos-cn-ve-15/exampleZhangjiajieVideoId/?a=6383&ch=0&cr=0&dr=0&lr=all&cd=0%7C0%7C0%7C3
Playable video URL. The query string carries required access parameters, so keep it intact.
- viewsinteger
2740000
Play count.
- widthinteger
1080
Pixel width of the video.
- foundboolean
true
True when the video was found.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Douyin Video API
The AnyAPI Douyin Video API returns Douyin video data as normalized JSON from one POST call to /v1/run/douyin.video. Fetch a public Douyin video by share URL with normalized author and engagement data. AnyAPI returns one normalized schema whichever source serves it. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Douyin video calls through AnyAPI succeeded, with a median response time of 2.3 seconds across 67 measured calls.
