Get video download URL - KonbiniAPI Docs

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

Field	Value
Tool name	`tiktok_get_video_download_url`
Platform	TikTok
REST endpoint	`GET /v1/tiktok/videos/{videoId}/download`
Result type	Detail tool

Parameters

Parameter	Type	Required	Description
`videoId`	`string`	Yes	TikTok video ID
`url`	`string`	No	Optional: 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_preset`	`string`	No	Defaults to `minimal`. Allowed values: `full`, `minimal`, `identity`, `engagement`, `content`.
`data_fields`	`string[]`	No	Adds 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.