TikTok Video Downloader API - Direct Video URLs

Language: English | 中文

English

TikTok video download URL API

TikTok Video Downloader API - Direct Video URLs converts public TikTok video IDs, video links, mobile share links, and TikTok short URLs into direct video playback/download URLs and structured metadata. It is a lightweight TikTok video downloader API for developers, no-code automations, and data pipelines that need the media URL without storing the video on an additional file host.

Paste up to 1,000 IDs or links, click Start, and receive one Dataset row per unique input. You can mix IDs and links in the same run. No TikTok login, API key, or user-supplied cookies are required. Run it from Apify Console or integrate it through the Apify API, webhooks, schedules, MCP, and automation tools such as Make or n8n.

This Actor returns media URLs and metadata. It does not download or permanently store the video file. TikTok CDN URLs are signed and can expire, so consume or save the media soon after a run.

Why use this TikTok video URL extractor?

• Bulk TikTok input processing: resolve up to 1,000 unique IDs or links per run.
• Direct video ID input: resolve numeric TikTok video IDs without constructing a URL.
• Short-link expansion: support vm.tiktok.com and other TikTok-owned share links.
• Direct video URLs: receive the best available playback/download URL and additional bitrate variants.
• Useful metadata: get the video ID, caption, creator, cover image, resolution, and bitrate.
• No browser automation: browser-impersonating HTTP requests keep runs lightweight and suitable for API workflows.
• Built for automation: export results or connect them to Apify schedules, webhooks, cloud storage, Make, n8n, and your own application.
• Request-and-result pricing: every accepted input produces a visible result; successful resolutions add a separate success charge.

Typical use cases include sending TikTok videos into transcription or video analysis pipelines, expanding mobile share links, refreshing expired TikTok CDN URLs, selecting a video quality, and collecting public metadata for videos that you are authorized to process.

What TikTok video data can the API extract?

Field	Type	Description
sourceUrl	string	Original TikTok video ID, video link, or short link supplied as input.
resolvedUrl	string	Canonical URL after a TikTok short link is expanded.
success	boolean	Whether the video URL and metadata were resolved.
videoId	string	Stable public TikTok video identifier.
title	string	Public TikTok caption or video description.
author	object	Public creator ID, username, and display name.
coverUrl	string	TikTok video cover image URL.
downloadUrl	string	Best available direct playback/download URL.
width, height	integer	Dimensions of the selected video stream.
bitrate	integer	Bitrate of the selected video stream.
variants	array	Other discovered video URLs, resolutions, and bitrates.
error	string	Safe explanation when success is false.

How to get a TikTok video download URL

1. Open the Actor's Input tab.
2. Paste a numeric TikTok video ID, public video URL, mobile share link, or vm.tiktok.com short link.
3. Add more IDs or links if you want to resolve them in bulk.
4. Click Start.
5. Open the Dataset and use downloadUrl, or export the results as JSON, CSV, Excel, or HTML.

For programmatic use, open the API tab for generated JavaScript, Python, CLI, HTTP, OpenAPI, and MCP examples.

How much does the TikTok downloader API cost?

The Actor charges $0.001 when a run starts, $0.0002 for each accepted video ID or TikTok URL processed into a visible Dataset result, and $0.0012 for each successful resolution. A run with one successful video costs $0.0024; a run with 100 successful videos costs $0.141.

Private, deleted, unavailable, or otherwise failed links still receive a Dataset row with success: false and incur the request charge, but not the success charge. Event prices include platform usage during the run. Dataset reads and long-term storage after the run remain subject to Apify's standard platform pricing. During a pricing transition, the request event is charged only after it appears in the run's effective pricing.

TikTok Video Download URL API input

The public input contains one backward-compatible field, urls. Each array item can be a numeric TikTok video ID, a normal TikTok video link, or a TikTok-owned short link. IDs and links can be mixed. Duplicate inputs are removed while their original order is preserved.

{
  "urls": [
    "6965506622420471045",
    "https://www.tiktok.com/@gordonramsayofficial/video/6965506622420471045",
    "https://vm.tiktok.com/example/"
  ]
}

See the Input tab for the interactive form. Networking, concurrency, and retry settings are managed by environment variables so the public input stays simple. The defaults use a US Apify Proxy, a 10-second timeout, one HTTP retry, and one full-resolution retry.

TikTok direct video URL output

Each unique input link produces one Dataset row. Results are written as each input finishes, in completion order. Saved rows remain available if the run stops early. Use sourceUrl to match each row to its input.

Billing and run progress are updated as rows are written, and pending work is stopped when the run charge limit is reached. You can download the Dataset in formats such as JSON, HTML, CSV, or Excel.

{
  "sourceUrl": "https://www.tiktok.com/@gordonramsayofficial/video/6965506622420471045",
  "resolvedUrl": "https://www.tiktok.com/@gordonramsayofficial/video/6965506622420471045",
  "success": true,
  "videoId": "6965506622420471045",
  "title": "Add some #Spanish flair to your toast this week...",
  "author": {
    "id": "6747935906352907269",
    "uniqueId": "gordonramsayofficial",
    "nickname": "Gordon Ramsay"
  },
  "coverUrl": "https://...",
  "downloadUrl": "https://...",
  "width": 720,
  "height": 1280,
  "bitrate": 904177,
  "variants": [
    { "width": 720, "height": 1280, "bitrate": 904177, "url": "https://..." }
  ],
  "error": null
}

TikTok downloader API example with HTTP

Use the generated examples in the API tab, or call the synchronous Dataset endpoint from your application:

curl --request POST \
  "https://api.apify.com/v2/acts/spider_studio~tiktok-video-resolver/run-sync-get-dataset-items" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"urls":["6965506622420471045"]}'

Tips for reliable TikTok video URL extraction

• Consume or copy downloadUrl soon after the run because TikTok CDN signatures can expire.
• Re-run an old link whenever you need a fresh direct video URL.
• Check success and error instead of assuming every public-looking URL is available.
• Split very large workflows into separate runs when you need independent progress tracking.
• Try the URLs in variants if your application needs a different resolution or bitrate.
• Invalid TikTok URLs are rejected immediately; temporary upstream failures use one bounded retry through a new US proxy connection with automatic IP selection.

Related TikTok Actors

• TikTok Profile & Public Videos Scraper resolves public TikTok profiles and retrieves a paginated page of their public videos.
• TikTok Bulk Video Search searches public TikTok videos by keyword and returns structured video records.

TikTok downloader API FAQ, legality, and support

Does this Actor download or store TikTok videos?

No. It extracts direct media URLs and public metadata. Your application decides whether to stream, download, or store the media. This avoids duplicate hosting costs but means the returned URL is not permanent.

Does it return TikTok videos without a watermark?

The Actor selects the best video stream exposed by TikTok, but it does not promise that every result is watermark-free. Check the returned media before building a workflow that requires a specific watermark state.

Can it resolve private, deleted, or region-blocked TikTok videos?

No. The video must be publicly available from the Actor's network location. Unavailable inputs return success: false, incur the request charge, and do not incur the successful-resolution charge.

Do I need a TikTok account, cookie, or official TikTok API key?

No TikTok login, user cookie, or TikTok API key is required. An Apify account is needed to run the Actor through Console or API.

This Actor extracts only information publicly exposed by TikTok. Results can still contain personal data that users chose to publish. Personal data is protected by the GDPR and other laws. Process it only with a legitimate reason, respect TikTok's terms and copyright rules, and consult legal counsel if you are unsure whether your use case is lawful.

Use the Actor's Issues tab for reproducible bug reports and the API tab for integration examples. Include the failed URL shape and run ID, but never publish Apify tokens or proxy credentials.

---

中文

TikTok 视频下载直链 API

TikTok Video Downloader API - Direct Video URLs 可以把公开 TikTok 作品链接、 视频 ID、移动端分享链接和 vm.tiktok.com 短链接转换成直接播放/下载地址与结构化元数据。它适合需要在 Python、JavaScript、n8n、Make 或自有应用中批量获取 TikTok 视频地址的开发者， 不需要 TikTok 登录、官方 API Key 或用户提供 Cookie。

每次 Run 最多处理 1,000 个不重复的视频 ID 或链接，两种格式可混合输入，每条输入生成一条 Dataset 结果。Actor 只 返回媒体地址，不会下载或永久保存视频文件；TikTok CDN 地址可能过期，建议运行完成 后尽快使用或保存视频。

为什么使用 TikTok 视频直链提取器？

• 支持直接输入纯数字视频 ID、标准作品链接、移动端分享链接和 TikTok 短链接。
• 批量返回视频 ID、文案、作者、封面、分辨率、码率和直接视频 URL。
• 返回多个清晰度与码率变体，便于下游选择格式。
• 可通过 Apify API、Webhook、定时任务、MCP、Make 和 n8n 自动化调用。
• 每次启动 $0.001，每条有效请求 $0.0002，每条成功结果另收 $0.0012。

如何获取 TikTok 视频下载地址？

1. 打开 Actor 的 Input 页面。
2. 粘贴一个或多个公开 TikTok 视频链接或短链接。
3. 点击 Start。
4. 在 Dataset 中读取 downloadUrl，或导出 JSON、CSV、Excel、HTML。

如需程序化调用，请打开 API 页面查看 JavaScript、Python、CLI、HTTP、OpenAPI 和 MCP 示例。

TikTok API 输入

{
  "urls": [
    "6965506622420471045",
    "https://www.tiktok.com/@gordonramsayofficial/video/6965506622420471045"
  ]
}

urls 数组中的每一项都可以是纯数字视频 ID 或 TikTok 链接。重复输入会自动去重并保留原顺序。 输出按处理完成顺序逐条写入，并更新计费和运行进度；可通过 sourceUrl 对应原输入。 运行提前停止时，已写入的结果仍保留在 Dataset 中。 并发、网络与重试策略由 Actor 管理，不需要用户配置。

TikTok 视频直链输出

核心字段包括：

字段	说明
resolvedUrl	短链接展开后的标准 TikTok 地址。
videoId	稳定的公开作品 ID。
title	视频公开文案。
author	作者 ID、用户名与昵称。
coverUrl	视频封面地址。
downloadUrl	当前最佳的直接播放/下载地址。
variants	其他分辨率、码率和视频地址。
success, error	解析状态与安全错误说明。

TikTok 视频链接解析价格

Actor 每次启动收费 $0.001，每条被接受并生成可见 Dataset 结果的视频 ID 或链接收费 $0.0002，每条成功解析的视频另收 $0.0012。单条成功结果总价为 $0.0024。 私密、已删除或暂时不可用的视频仍会输出 success: false，收取请求费但不收成功费。 Run 期间的平台用量已包含在事件价格中。

其它 TikTok Actors

• TikTok 主页与公开视频抓取器：解析公开 TikTok 主页，并获取一页可分页的公开视频。
• TikTok 批量视频搜索：按关键词搜索公开视频并返回结构化视频数据。

常见问题、合规与支持

Actor 会下载或永久存储视频吗？

不会。它只返回 TikTok 当前公开的媒体 URL 和元数据，下载或存储由下游应用决定。

返回的视频一定无水印吗？

不保证。Actor 会选择 TikTok 暴露的最佳视频流，但不会承诺所有结果都没有水印。

可以解析私密或已删除的视频吗？

不可以。视频必须能够从 Actor 当前网络位置公开访问。

本 Actor 只提取 TikTok 公开展示的信息，但结果仍可能包含用户主动公开的个人数据。 你有责任遵守 TikTok 服务条款、版权规定及适用法律；如果无法判断使用场景是否合法， 请咨询法律专业人士。

如需反馈问题，请使用 Actor 的 Issues 页面；集成示例位于 API 页面。提交问题 时可以提供失败链接格式和 Run ID，但不要公开 Apify Token 或代理凭据。