Video Download API documentation

EasyDown REST API platform guide

TikTok Download API

Normal video pages, photo posts, and TikTok share redirects all use the same authenticated REST request. EasyDown normalizes the result without discarding alternate qualities or gallery items.

Parse public TikTok videos, photo posts, and share links with the EasyDown TikTok Download API and receive every available video, image, audio, and cover candidate.

TikTok video download API · TikTok photo post API

Production REST endpoint

POST https://api.easydown.org/api/v1/parse

Supported public URL formats

tiktok.com/@user/video/{id}tiktok.com/@user/photo/{id}tiktok.com/t/{code}vm.tiktok.com/{code}

Real request example

https://www.tiktok.com/@jesscreatescontent/video/7647557116596718861

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@jesscreatescontent/video/7647557116596718861"}'

Platform response example

The shared envelope stays stable while this platform determines which media arrays and attributes are populated.

Media behavior

Video posts may return several video qualities, cover images, and audio. Photo posts return every public gallery image exposed by the source response.

{
  "status": 200,
  "data": {
    "platform": "tiktok",
    "title": "Example tiktok 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"
}

Download and proxy rules

Use a backend proxy with Referer: https://www.tiktok.com/ and a browser User-Agent. Some media requires a valid access cookie from your own browsing context, and availability can vary by server region.

Recommended backend request headers

User-Agent: Mozilla/5.0 Referer: https://www.tiktok.com/ Range: bytes=0-

Unsupported or unavailable content

Profiles, LIVE pages, sound pages, search results, TikTok Lite pages, private posts, deleted posts, 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.

Platform-specific troubleshooting

Resolve short share URLs before caching their final post URL.

Re-parse when a media URL returns 403 or 404 because TikTok links can expire.

Do not expose API tokens or source cookies in browser JavaScript.

REST integration workflow

  1. 1

    Create a private API token and allow this platform in its permissions.

  2. 2

    POST one complete public post URL to the shared endpoint.

  3. 3

    Select and proxy the required items from images, videos, and audios.

Download API questions

Which TikTok URLs does the download API support?

Supported public single-post formats include tiktok.com/@user/video/{id}, tiktok.com/@user/photo/{id}, tiktok.com/t/{code}, vm.tiktok.com/{code}. Profiles, LIVE pages, sound pages, search results, TikTok Lite pages, private posts, deleted posts, and region-unavailable media are unsupported.

What media does the TikTok Download API return?

Video posts may return several video qualities, cover images, and audio. Photo posts return every public gallery image exposed by the source response.

How should my application download returned TikTok media URLs?

Use a backend proxy with Referer: https://www.tiktok.com/ and a browser User-Agent. Some media requires a valid access cookie from your own browsing context, and availability can vary by server region.

How is a successful TikTok API request billed?

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.