TikTok Public Media Downloader

What does TikTok Public Media Downloader do?

TikTok Public Media Downloader resolves public TikTok post metadata through the configured public TikWM endpoint, validates that the response matches the requested video ID, and stores the requested public cover and/or video bytes in the run's default key-value store. It does not log in, access private accounts, solve CAPTCHAs, bypass DRM, or defeat access controls.

Why use TikTok Public Media Downloader?

Use it when a lawful workflow needs durable run artifacts rather than an expiring CDN URL. Each successful dataset row links the resolved metadata and the stored artifact keys. A failing URL does not create a fake success row; it is summarized in OUTPUT_SUMMARY and can optionally produce a minimal diagnostic row.

How to download public TikTok media

1. Enter one or more public /video/<id> URLs in the Input tab.
2. Choose whether to store the video, cover, or both.
3. Set the per-file size limit and conservative retry/timeout controls.
4. Run the Actor and open the dataset or key-value-store artifact links.

What data can it extract?

Group	Fields
Identity	videoId, postUrl, resolverUrl
Public metadata	title, authorId, authorUsername, authorName, authorAvatarUrl, duration, dimensions, counts, sound fields
Media	thumbnailUrl, playbackUrl, videoContentType, coverContentType
Artifacts	videoKey, videoRecordUrl, videoSizeBytes, coverKey, coverRecordUrl, coverSizeBytes
Provenance	source, provenance, resolver, downloadedAt
Diagnostics	Optional {url,error,errorCode,scrapedAt} only

The resolver and CDN are external public dependencies. Returned playback URLs may expire; key-value-store files are the durable run artifacts. Content type, byte size, HTTPS URL, and video-ID association are checked before storage.

Input

videoUrls is required and accepts 1–10 public HTTPS TikTok video URLs. maxItems defaults to 3 and is bounded to 1–10. downloadVideo and downloadCover default to true; at least one must remain enabled. maxFileSizeMb defaults to 100 and is bounded to 1–250. Developer controls are requestTimeoutSecs (10–120, default 60), maxRequestRetries (0–3, default 2), and requestDelayMs (0–5000, default 0). includeDiagnostics defaults to false. fixturePath is an explicit local QA JSON file below test/fixtures and never becomes a live fallback.

{
  "videoUrls": ["https://www.tiktok.com/@creator/video/1234567890"],
  "maxItems": 1,
  "downloadVideo": true,
  "downloadCover": true,
  "maxFileSizeMb": 25
}

Output

{
  "source": "tiktok.com via tikwm.com public API",
  "provenance": "public_tiktok_media_resolver",
  "videoId": "1234567890",
  "postUrl": "https://www.tiktok.com/@creator/video/1234567890",
  "title": "Public caption",
  "authorUsername": "creator",
  "thumbnailUrl": "https://cdn.example/cover.jpg",
  "playbackUrl": "https://cdn.example/video.mp4",
  "coverKey": "cover_1234567890",
  "videoKey": "video_1234567890",
  "videoSizeBytes": 123456,
  "coverSizeBytes": 1234,
  "downloadedAt": "2026-08-18T00:00:00.000Z"
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

Tips and advanced options

Start with one URL and a conservative file-size limit. Large videos consume more compute and key-value storage. The Actor processes URLs sequentially and uses bounded retries. Fixture QA validates the artifact-writing path but is not evidence that the live resolver or current CDN succeeded.

FAQ, support, and responsible use

If a resolver or CDN is unavailable, inspect OUTPUT_SUMMARY for the failed URL and error code. This Actor is not affiliated with TikTok or TikWM. Download only media you are permitted to use, respect terms, rate limits, copyright, privacy obligations, and applicable law, and do not use it to bypass restrictions. Include the run ID and summary when reporting an issue.