Download TikTok video

Download a TikTok video with optional signed URL and inline delivery.

← All TikTok endpoints · Capability overview

GET/v1/tiktok/video/download

https://api.vee3.io/v1/tiktok/video/download

10 tokens

Download a TikTok video with optional signed URL and inline delivery.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

download_tiktok_video

Parameters4 fields

video_idstringOptional

TikTok video id.

max length 32

video_urlstringOptional

TikTok video URL.

max length 2048

return_mode"url" | "file" | "both"Optional

How to deliver the result. 'url' returns signed download URLs only. 'file' returns inline base64 when the file is under 10 MB. 'both' returns signed URLs plus inline base64 when small enough.

Default: "both"

include_hdplaybooleanOptional

When true, also download the high-definition hdplay variant. Defaults to false.

Default: false

Response4 fields

download_idstring

Unique download identifier, prefix td_.

return_modeenum

Echo of the requested delivery mode.

playstring

Signed download URL for the standard-quality video.

hdplaystring

Signed download URL for the high-definition video when include_hdplay is true.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty, internal_error

On HTTP 200 (success body): inline_file_unavailable

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/video/download"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943",
    "return_mode": "url"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses2 examples

200Signed standard-quality play download URL.

signed_play_url.json

{
  "download_id": "td_7516594811734854943",
  "return_mode": "url",
  "play": "https://storage.googleapis.com/vee3-downloadables/tiktok-downloads/td_example_play.mp4?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Expires=3600",
  "play_file_size_bytes": 7786703,
  "play_content_type": "video/mp4"
}

200Signed play and hdplay URLs when include_hdplay is true.

signed_play_and_hdplay_urls.json

{
  "download_id": "td_7516594811734854943",
  "return_mode": "url",
  "play": "https://storage.googleapis.com/vee3-downloadables/tiktok-downloads/td_example_play.mp4?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Expires=3600",
  "play_file_size_bytes": 7786703,
  "play_content_type": "video/mp4",
  "hdplay": "https://storage.googleapis.com/vee3-downloadables/tiktok-downloads/td_example_hdplay.mp4?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Expires=3600",
  "hdplay_file_size_bytes": 38711004,
  "hdplay_content_type": "video/mp4"
}