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. A failed request, empty response, or unavailable post alone does not trigger a charge. A no-media request is charged only when both a processing cost and a clear content restriction are confirmed. This exception currently applies to Douyin and Toutiao only. Unsupported URLs, input validation failures, invalid or unauthorized API tokens, temporary failures, timeouts, and unexplained empty results cost 0 credits. Unavailable content without a confirmed processing cost is also free.

Video Downloader API quick start

1. API authentication

2. Request

3. Response

On this page