Skip to main content

​
What it does

Returns a video file URL you can download directly with a plain GET request — no cookies, no auth headers, no browser fingerprinting needed on your end. Not permanent, only valid for a few hours.

​
Tool details

FieldValue
Tool nametiktok_get_video_download_url
PlatformTikTok
REST endpointGET /v1/tiktok/videos/{videoId}/download
Result typeDetail tool

​
Parameters

ParameterTypeRequiredDescription
videoIdstringYesTikTok video ID
urlstringNoOptional: an aweme/v1/play/ URL copied from a prior video detail response for this same video. Providing it lets this endpoint skip re-fetching the video detail internally.
projection_presetstringNoDefaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fieldsstring[]NoAdds top-level keys from data on top of the selected projection_preset.

​
Example

{
  "name": "tiktok_get_video_download_url",
  "arguments": {
    "videoId": "7526718640041882912",
    "projection_preset": "minimal",
    "data_fields": [
      "url",
      "type",
      "mediaType"
    ]
  }
}

​
Available data fields

  • @context
  • type
  • url
  • mediaType

​
Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.