Video Extract Guide
Learn how to extract video metadata from social media share links, authenticate requests, handle responses, and track fixed-price usage.
Extract video download info from social media share links. Paste a URL (or raw share text), get multi-quality video streams, audio tracks, cover images, and metadata — all in one request.
Quick Start
Get your API Key
Go to the Dashboard and create an API key.
Make a request
Pass any supported video URL as the url parameter:
curl -G "https://api.undersky.ai/v1/social-media/video/extract" \
--data-urlencode "url=https://v.douyin.com/L4FJNR3/" \
-H "Authorization: Bearer sk-your-api-key"Get the result
The response includes normalized metadata and multi-quality download options:
{
"platform": "douyin",
"data": {
"videoId": "6918273131559881997",
"title": "骑白马的也可以是公主#百万转场变身",
"author": "Real机智张",
"duration": 10,
"videos": [
{ "url": "https://...mp4", "quality": "1080p", "format": "mp4", "width": 1080, "height": 1920 },
{ "url": "https://...mp4", "quality": "720p", "format": "mp4", "width": 720, "height": 1280 }
],
"audios": [
{ "url": "https://...mp3", "format": "mp3" }
]
}
}Supported Platforms
| Platform | URL Formats | Video | Audio | Notes |
|---|---|---|---|---|
| Douyin | v.douyin.com/* | Multi-quality (1080p/720p/540p) | Background music MP3 | Shares parser with TikTok |
| Kuaishou | v.kuaishou.com/*, *.gifshow.com/* | Multi-quality | Yes | — |
| Bilibili | bilibili.com/video/BV*, b23.tv/* | DASH multi-stream | DASH separate audio | Requires ffmpeg to merge |
| Xiaohongshu | xiaohongshu.com/*, xhslink.com/* | H.264/H.265 | — | Multiple codecs |
weibo.com/*, weibo.cn/* | 720p/HD/LD | — | — | |
| Xigua | ixigua.com/* | Yes | — | — |
| Pipixia | pipix.com/*, pipixia.com/* | high/low | — | — |
Audio note: "—" means audio is embedded in the video file (audios returns empty array). Bilibili and YouTube use DASH format with separate audio/video — use ffmpeg to merge. Douyin/TikTok audios are standalone background music.
Try It — Test URLs
Copy any URL below and use it directly with the API:
curl -G "https://api.undersky.ai/v1/social-media/video/extract" \
--data-urlencode "url=https://v.douyin.com/L4FJNR3/" \
-H "Authorization: Bearer sk-your-api-key"Returns 4 quality options (1080p → 540p) + 1 background music MP3.
Paste Share Text Directly
No need to manually extract URLs. Paste the raw share text from any app:
The API automatically extracts the https:// link from the text and parses it.
Use Cases
Video Download
Get watermark-free video in multiple resolutions. Let users choose the quality they need.
Video to Text
Extract the audio track, then use Audio Transcription to convert speech to text.
Content Extraction
Get video title, author info, and description for content repurposing or translation.
Cross-platform Repost
Pick the best quality from the videos array and repost to another platform.
Pricing
Each successful request costs $0.01 credit. Failed requests are not billed.
Video and audio URLs are time-limited (typically hours to a few days). Download promptly after retrieval.
For full parameter specs and response schema, see the API Reference.