aweme_idsstring
Video id list, separated by commas, for example: "123,456,789", up to 50.
https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-high-quality-play-urlReturns highest-quality direct video playback URLs for multiple Douyin videos based on comma-separated video IDs, with optional CDN region targeting.
[
{
"data": {
"failed_count": 0,
"success_count": 3,
"total": 3,
"videos": [
{
"content_type": "video/mp4",
"file_size": "82274121",
"file_size_in_mb": 78.46,
"original_video_url": "https://v9-colds.douyinvod.com/8b606e1461ca9f082d015f73025873e3/6a86dafb/video/tos/cn/tos-cn-v-0015c800/ooEeAYuCeuIAzDrAghgYXL44gAeRABerCIVbU2/",
"success": true,
"video_id": "7512756548356492544"
},
{
"content_type": "video/mp4",
"file_size": "15718454",
"file_size_in_mb": 14.99,
"original_video_url": "https://v5-hl-zenl-ov.zjcdn.com/8b8a998c8cc14bffd5f35b27c268939a/6a86dd24/video/tos/cn/tos-cn-ve-15/oI0EdeRAyCBGnjydA7e21feSDuCL6FIdAgURdN/?a=1128&ch=0&cr=0&dr=0&cd=0%7C0%7C0%7C0&cv=1&br=217&bt=217&cs=0&ds=3&ft=LoM-81H7sQOCCp5Sup-Q6_Mme-rLWa5eFPjeUCd-IT6R5MuwUBMEq&mime_type=video_mp4&qs=0&rc=aWhpOjxmPDtoaWZnN2Y6ZkBpanU0Z3Y5cmVqdzMzNGkzM0AuMmIxMC4yXi4xXzZgYmJfYSNmYi9oMmRzZmJgLS1kLWFzcw%3D%3D&btag=80010e000b0001&cquery=100y_10sH&dy_q=1787219168&feature_id=aa7df520beeae8e397df15f38df0454c&l=202608201746081F3DB534987A1CDE02B7",
"success": true,
"video_id": "7448118827402972455"
},
{
"content_type": "video/mp4",
"file_size": "3337266",
"file_size_in_mb": 3.18,
"original_video_url": "https://v11-colds.douyinvod.com/0d3e23ccc50a2c788762db7901645039/6a86db00/video/tos/cn/tos-cn-ve-15c001-alinc2/d49b945369c64852a44f8f3e5bf4b433/?a=1128&ch=0&cr=0&dr=0&cd=0%7C0%7C0%7C0&cv=1&br=1773&bt=1773&cs=0&ds=3&ft=inBG-fZfjCddc~ORcgjWe68JgbGT4~JEINJ9dug3zWU~6RQ9H6KM&mime_type=video_mp4&qs=0&rc=OGc6OTo6Zzg7NTY6ZzY6NkBpM3RoaDo6ZnBuZTMzNGkzM0AuMTIvYC9gXmAxLzY2YDZgYSNoc2RxcjRnY2dgLS1kLS9zcw%3D%3D&btag=80010e00090000&cquery=10sH_100y&dy_q=1787219170&l=20260820174610894585977D2CA89EBC26",
"success": true,
"video_id": "7126745726494821640"
}
]
}
}
]Select an example to load its inputs and result into the playground.
Fetch direct high-quality video playback URLs in batches by supplying comma-separated video IDs via aweme_ids. You can also specify region to route to regional CDNs for faster access.
curl -X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-high-quality-play-url" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
| Name | Type | Required | Description |
|---|---|---|---|
region | string | No | Optional ISO country code (for example, CN, US, or HK). |
aweme_ids | string | No | Video id list, separated by commas, for example: "123,456,789", up to 50. |
Real response for the request above, trimmed to the main fields. User names and long IDs are masked.
{
"videos": [
{
"content_type": "video/mp4",
"original_video_url": "https://v9-colds.douyinvod.com/492702c4e428390a26b1578fe5e5b5ac/6ac4fa06/video/t…",
"video_id": "7512756548356492544"
}
]
}
aweme_ids.region to select regional CDN links.Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-high-quality-play-url" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
aweme_idsstringVideo id list, separated by commas, for example: "123,456,789", up to 50.
regionanyOptional ISO country code (for example, CN, US, or HK). Pass CN for users in mainland China to get China-region CDN URLs for faster downloads.
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"failed_count": 0,
"success_count": 3,
"total": 3,
"videos": [
{
"content_type": "video/mp4",
"file_size": "82274121",
"file_size_in_mb": 78.46,
"original_video_url": "https://v9-colds.douyinvod.com/8b606e1461ca9f082d015f73025873e3/6a86dafb/video/tos/cn/tos-cn-v-0015c800/ooEeAYuCeuIAzDrAghgYXL44gAeRABerCIVbU2/",
"success": true,
"video_id": "7512756548356492544"
},
{
"content_type": "video/mp4",
"file_size": "15718454",
"file_size_in_mb": 14.99,
"original_video_url": "https://v5-hl-zenl-ov.zjcdn.com/8b8a998c8cc14bffd5f35b27c268939a/6a86dd24/video/tos/cn/tos-cn-ve-15/oI0EdeRAyCBGnjydA7e21feSDuCL6FIdAgURdN/?a=1128&ch=0&cr=0&dr=0&cd=0%7C0%7C0%7C0&cv=1&br=217&bt=217&cs=0&ds=3&ft=LoM-81H7sQOCCp5Sup-Q6_Mme-rLWa5eFPjeUCd-IT6R5MuwUBMEq&mime_type=video_mp4&qs=0&rc=aWhpOjxmPDtoaWZnN2Y6ZkBpanU0Z3Y5cmVqdzMzNGkzM0AuMmIxMC4yXi4xXzZgYmJfYSNmYi9oMmRzZmJgLS1kLWFzcw%3D%3D&btag=80010e000b0001&cquery=100y_10sH&dy_q=1787219168&feature_id=aa7df520beeae8e397df15f38df0454c&l=202608201746081F3DB534987A1CDE02B7",
"success": true,
"video_id": "7448118827402972455"
},
{
"content_type": "video/mp4",
"file_size": "3337266",
"file_size_in_mb": 3.18,
"original_video_url": "https://v11-colds.douyinvod.com/0d3e23ccc50a2c788762db7901645039/6a86db00/video/tos/cn/tos-cn-ve-15c001-alinc2/d49b945369c64852a44f8f3e5bf4b433/?a=1128&ch=0&cr=0&dr=0&cd=0%7C0%7C0%7C0&cv=1&br=1773&bt=1773&cs=0&ds=3&ft=inBG-fZfjCddc~ORcgjWe68JgbGT4~JEINJ9dug3zWU~6RQ9H6KM&mime_type=video_mp4&qs=0&rc=OGc6OTo6Zzg7NTY6ZzY6NkBpM3RoaDo6ZnBuZTMzNGkzM0AuMTIvYC9gXmAxLzY2YDZgYSNoc2RxcjRnY2dgLS1kLS9zcw%3D%3D&btag=80010e00090000&cquery=10sH_100y&dy_q=1787219170&l=20260820174610894585977D2CA89EBC26",
"success": true,
"video_id": "7126745726494821640"
}
]
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Douyin | $0.38 per call | JSON |
Douyin | $0.0015 per call | JSON |
Douyin | $0.0015 per call | JSON |
Douyin | $0.0015 per call | JSON |
Douyin | $0.0015 per call | JSON |
Douyin | $0.0015 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-high-quality-play-url with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.38 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
No parameters are required. Optional: aweme_ids (string) and region (any). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Douyin Multi-Video High Quality Play URLs runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.