EasyDown REST API platform guide
EasyDown keeps the work ID as a string, resolves share URLs when required, and returns the same REST response shape for Douyin video and photo-note content.
Use the EasyDown Douyin Download API for public videos, image notes, share links, selected detail URLs, and supported Douyin media links.
Douyin video download API · Douyin photo note API
Production REST endpoint
POST https://api.easydown.org/api/v1/parsev.douyin.com/{code}douyin.com/video/{id} or /share/video/{id}douyin.com/note/{id} or /share/note/{id}douyin.com/shipin/{id}douyin.com/lvdetail/{id} or /vsdetail/{id}so.douyin.com/video/detail?aweme_id={id}douyin.com/user/{userId}?vid={id}douyin.com/...?modal_id={id}douyin.com, iesdouyin.com, or aweme.snssdk.com /aweme/v1/play?...video_id={id}*.douyinpic.com, *.douyinvod.com, or *.douyinstatic.com media URLhttps://so.douyin.com/video/detail?aweme_id=7642916558104300826
curl -X POST https://api.easydown.org/api/v1/parse \
-H "Authorization: Bearer ed_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://so.douyin.com/video/detail?aweme_id=7642916558104300826"}'The shared envelope stays stable while this platform determines which media arrays and attributes are populated.
The response can include mapped video qualities, audio, covers, and note images. Supported direct-media URLs avoid an unnecessary upstream post lookup.
{
"status": 200,
"data": {
"platform": "douyin",
"title": "Example douyin public post",
"thumbnail": "https://cdn.example.com/thumbnail.jpg",
"duration": 24,
"images": [
{
"url": "https://cdn.example.com/content-image.jpg",
"width": 1080,
"height": 1350
}
],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct"
}
],
"audios": [
{
"url": "https://cdn.example.com/audio.m4a",
"quality": "128kbps",
"mimeType": "audio/mp4"
}
]
},
"msg": "success"
}Use Referer: https://www.douyin.com/, a browser User-Agent, and forwarded Range headers from a backend proxy. Douyin media signatures are short lived and may require a region with public access.
User-Agent: Mozilla/5.0
Referer: https://www.douyin.com/
Range: bytes=0-Profiles without a work ID, search results, follow pages, collections, live pages, private content, deleted works, and region-unavailable media are unsupported.
Only process public media you have the right to use. EasyDown does not bypass privacy controls, DRM, deleted content, or platform access restrictions.
Resolve v.douyin.com share links before storing a canonical work URL.
Forward Range for large video responses.
Re-parse immediately after a signed URL returns 403 or 404.
Create a private API token and allow this platform in its permissions.
POST one complete public post URL to the shared endpoint.
Select and proxy the required items from images, videos, and audios.
Use the MCP endpoint for AI agents, or open the browser tool for a manual public-media workflow.
Supported public single-post formats include v.douyin.com/{code}, douyin.com/video/{id} or /share/video/{id}, douyin.com/note/{id} or /share/note/{id}, douyin.com/shipin/{id}, douyin.com/lvdetail/{id} or /vsdetail/{id}, so.douyin.com/video/detail?aweme_id={id}, douyin.com/user/{userId}?vid={id}, douyin.com/...?modal_id={id}, douyin.com, iesdouyin.com, or aweme.snssdk.com /aweme/v1/play?...video_id={id}, *.douyinpic.com, *.douyinvod.com, or *.douyinstatic.com media URL. Profiles without a work ID, search results, follow pages, collections, live pages, private content, deleted works, and region-unavailable media are unsupported.
The response can include mapped video qualities, audio, covers, and note images. Supported direct-media URLs avoid an unnecessary upstream post lookup.
Use Referer: https://www.douyin.com/, a browser User-Agent, and forwarded Range headers from a backend proxy. Douyin media signatures are short lived and may require a region with public access.
A response containing at least one image, video, or audio URL costs 1 credit. Failed, unsupported, authentication, and empty-media results do not consume credits.