Video Downloader API quick start
Send your first authenticated social media video downloader API request and read the normalized media response.
1. API authentication
Send the token in the Authorization header. Never place production tokens in URLs, client logs, source control, or analytics.
2. Request
curl --request POST \
--url https://api.easydown.org/api/v1/parse \
--header 'Authorization: Bearer ed_live_your_token' \
--header 'Content-Type: application/json' \
--data '{"url":"https://www.youtube.com/watch?v=BiBY6TeIvJ4"}'3. Response
{
"status": 200,
"data": {
"platform": "youtube",
"title": "BTS (방탄소년단) 'Come Over' Lyric Video",
"thumbnail": "https://i.ytimg.com/vi/MEoxtFRfPoc/hq720.jpg?sqp=-oaymwEhCK4FEIIDSFryq4qpAxMIARUAAAAAGAElAADIQj0AgKJD&rs=AOn4CLAJ24Z7XtZaKWlxvJNLf8ExlyN80Q",
"duration": 179,
"images": [],
"videos": [
{
"url": "https://rr4---sn-ab5sznzy.googlevideo.com/videoplayback?expire=1789636957&ei=_VyraqnaEuK_kucP74rysQc&ip=98.7.89.183&id=o-AMlyyKcD_R1T2OfJnPAFtWYKIm-WnZBE2vV644WGYOTa&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1789615357%2C&mh=cK&mm=18%2C29&mn=sn-ab5sznzy%2Csn-ab5l6nrk&ms=aub%2Crdu&mv=m&mvi=4&pl=17&rms=aub%2Caub&pcm2=yes&initcwndbps=3308750&bui=AR3QkAk1pTKGB-U9BICLosauco6DnmpEzVatJRKaRy4qNbqMfV0kxVJm5_FA16vMrX-bR2SODtxvQbG-&spc=I-rgIVTtmcH2GYx9b5hEHhCOf9bJ9hK4lOvdTEPJjAIsGFyx-fkXw3S4abNn-Gi1JCSFReMZsaY&vprv=1&svpuc=1&mime=video%2Fmp4&ns=L54F9tBZDUCOnlT-qWflsjoY&rqh=1&gir=yes&clen=12858358&ratebypass=yes&dur=179.258&lmt=1781321367286599&mt=1789614994&fvip=5&fexp=51565115&c=MWEB&sefc=1&txp=4538534&n=bALPUXRu8ryZUg&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cpcm2%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Cns%2Crqh%2Cgir%2Cclen%2Cratebypass%2Cdur%2Clmt&lsparams=met%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRQIgIjQsA8i5SWa9AiqBUmgTvXBtHG_6swLZwwbipZWmXQsCIQCwEy_N_39FlIs3swUXx_SxNuoLFKjBVoOhJWAxavYLdw%3D%3D&pot=MlVqAMnXrIhjr2o-SnfHMPVNTA_RrWBV6HxD-sYgxVz8JsGPsQ8LIkqeQcK8DAI-B53E7WG9IgP_HAXIC9d_MNnHlu0W3ivPsmpzrsPFzs_6IxiucdAW&sig=AE0s2JYwRQIgZW8GabVmTPxgunhHp22ResI5ZJUGgcoI5uMYDC8FXgkCIQDqzSPuBh6s5jwsA1F59D0CVgRjGsu_pCAPPi0MojvtSg%3D%3D",
"quality": "360p",
"mimeType": "video/mp4",
"width": 480,
"height": 360,
"hasAudio": true,
"source": "direct",
"headers": {}
}
],
"audios": [
{
"url": "https://rr4---sn-ab5sznzy.googlevideo.com/videoplayback?expire=1789636957&ei=_VyraqnaEuK_kucP74rysQc&ip=98.7.89.183&id=o-AMlyyKcD_R1T2OfJnPAFtWYKIm-WnZBE2vV644WGYOTa&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1789615357%2C&mh=cK&mm=18%2C29&mn=sn-ab5sznzy%2Csn-ab5l6nrk&ms=aub%2Crdu&mv=m&mvi=4&pl=17&rms=aub%2Caub&pcm2=yes&initcwndbps=3308750&bui=AR3QkAnDCviXLrBXpjM1vdtPizn2CGaIPPvrIpWQm7M0WTiWfDFbaJAEhxi6tBD6FnyHNNrCtFB-q46O&spc=I-rgIVTumcH2GYx9b5hEHhCOf9bI9hK4lOvdTEPJjAIsGFyx-fkXw3S4abNn-Gi1JBSAreOF&vprv=1&svpuc=1&mime=audio%2Fmp4&ns=LWndp5pVjl93USANQI-yVbsY&rqh=1&gir=yes&clen=2901851&dur=179.258&lmt=1781320971774891&mt=1789614994&fvip=5&keepalive=yes&fexp=51565115&c=MWEB&sefc=1&txp=4532534&n=4Fp5CVk11afDiw&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cpcm2%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Cns%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&lsparams=met%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRQIgIjQsA8i5SWa9AiqBUmgTvXBtHG_6swLZwwbipZWmXQsCIQCwEy_N_39FlIs3swUXx_SxNuoLFKjBVoOhJWAxavYLdw%3D%3D&pot=MlVqAMnXrIhjr2o-SnfHMPVNTA_RrWBV6HxD-sYgxVz8JsGPsQ8LIkqeQcK8DAI-B53E7WG9IgP_HAXIC9d_MNnHlu0W3ivPsmpzrsPFzs_6IxiucdAW&sig=AE0s2JYwRQIgTurOgI0AmwjY8B8XozN9iNFF66eKxsHmmJGb_HOZ3CYCIQCyW9K0YMGpGx-OD-rZwjF6aeKfGSmssfpAJJnVqNrQnA%3D%3D",
"quality": "AUDIO_QUALITY_MEDIUM",
"mimeType": "audio/mp4",
"bitrate": 130607,
"source": "adaptive",
"headers": {}
}
]
},
"msg": "success"
}Successful parses are charged by platform. Most other supported platforms: 1 credit; YouTube: 3 credits; Threads: 2 credits; Kuaishou / Kwai: 2 credits; RedNote / Xiaohongshu: 10 credits. Failed, unsupported, authentication, permission, no-media, and upstream failure responses charge 0 credits.
Social Media Video Downloader API
Developer docs for one video downloader API across TikTok, YouTube, Instagram, X, RedNote, Bilibili, Douyin, Threads, Kuaishou, Weibo, and Toutiao.
API authentication
Authenticate EasyDown video downloader API requests with a Bearer token and keep production credentials secure.