TikTok Video Downloader API - Direct Video URLs

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.