TikTok Video Downloader — MP4, MP3 & Photo Posts
Pricing
from $3.00 / 1,000 saved mp4 with metadata
TikTok Video Downloader — MP4, MP3 & Photo Posts
Download public TikTok videos as MP4, slideshow photo posts as images and the sound as MP3/M4A, saved in Apify with file links. Short links supported, up to 50 posts per run, with views, likes and comments. Failed, partial and duplicate posts are free.
Pricing
from $3.00 / 1,000 saved mp4 with metadata
Rating
5.0
(1)
Developer
AGENT DOJO
Maintained by CommunityActor stats
0
Bookmarked
8
Total users
6
Monthly active users
21 hours ago
Last modified
Categories
Features
Share
Save public TikTok videos as MP4 files, photo (slideshow) posts as image files and, optionally, the post sound as MP3/M4A — all stored in Apify — and collect titles, authors and engagement metrics. Use saved files for your video archive, or choose metadata-only mode for data workflows. Full video URLs and TikTok short links are supported.
Formats explicitly flagged as watermarked are skipped. Other formats may have unknown watermark status; this Actor does not guarantee watermark-free output or remove logos.
Quick start
{"urls": ["https://www.tiktok.com/@waffleskkw/video/7678161526284602644"],"downloadVideo": true,"requireUnmarkedFormat": false,"maxVideoSizeMb": 25,"proxyConfiguration": {"useApifyProxy": false}}
Provide 1–50 links per run: video links, photo post links (/@user/photo/ID) and short links. Profiles, hashtags and other platforms are unsupported. Duplicate input URLs and duplicate video IDs produce at most one result per run. MP4 access verification is always enabled; there is no separate switch to configure. Saved files are limited to 25 MiB by default, configurable up to 50 MiB. Downloads are processed one at a time with a 3-second pause between video attempts. The extractor also pauses 1 second between supported metadata requests. These are conservative defaults, not a guaranteed safe TikTok rate.
What you receive
Successful dataset rows include status, video_id, title, author, views, likes, comments, duration_seconds, cover_image, direct_download_url, media_headers, media_url_verified, watermark_status, watermark_checked_visually and scraped_at. Every row has post_type (video or photo). Saved videos also include video_file_url, video_file_key and video_size_bytes. Photo posts include image_count, temporary image_urls, and in saved-file mode image_file_urls, image_file_keys and image_size_bytes (all photos, up to 35, in post order); duration_seconds and direct_download_url are null for them. With downloadAudio: true, rows also include audio_file_url/audio_file_key, or audio_error (AUDIO_NOT_AVAILABLE, AUDIO_DOWNLOAD_FAILED, AUDIO_TOO_LARGE, STORAGE_FAILED) when the sound could not be saved — a missing sound never turns a complete video or slideshow into a failure. Error rows contain the input URL, status, error code/message and collection timestamp instead of full video metadata.
Use video_file_url for a saved MP4. Apify storage retention depends on the account and storage lifecycle; copy files to your own storage if you need long-term retention. The URL returned by Apify can be accessed by anyone who knows it. Temporary direct_download_url links can expire or depend on the original session/IP. Access verification is a check at collection time, not a guarantee that a TikTok URL works from another client.
ok: metadata and verified MP4 access; in saved-file mode the MP4 was also downloaded and saved before the result is delivered.partial: metadata is available, but a usable media result was not completed.error: the input was invalid or TikTok could not be accessed.
A photo post is ok only when every photo was fetched (and, in saved-file mode, saved); otherwise it is partial without a result fee. Photo posts are read from TikTok's web page data; the sound of a slideshow is usually M4A.
Error codes include INVALID_URL, RATE_LIMITED, STORAGE_FAILED, RUN_SIZE_LIMIT, BLOCKED, POST_RESTRICTED, TIMEOUT, UNAVAILABLE, EXTRACTION_FAILED, NO_DIRECT_MP4, MEDIA_ACCESS_FAILED, MEDIA_DOWNLOAD_FAILED, VIDEO_TOO_LARGE, MEDIA_DOWNLOAD_TIMEOUT, INVALID_MP4, ONLY_WATERMARKED_FORMATS and WATERMARK_NOT_CONFIRMED. Missing metrics remain null. A run stops on a rate-limit response (RATE_LIMITED), or after three consecutive access, network or storage failures to limit wasted work. POST_RESTRICTED means TikTok served the page but restricted that single post for the requesting network or region (often a regional restriction); it does not count towards the consecutive-failure stop, and the URL is listed in retry_urls. Retrying it through a proxy in another country may help, but access is not guaranteed. A storage failure produces a partial row without a result fee. OUTPUT contains result counts and the stop reason. Zero complete results fail the run, except graceful event-budget, processing-time or total-size stops. Mixed or early-stopped batches have PARTIAL in OUTPUT.
Can I download without the TikTok watermark?
The Actor retrieves available source MP4 formats; it does not erase logos, crop frames or remove text embedded by the creator. Formats explicitly marked as watermarked are never returned or saved. An explicit unmarked flag/format label is preferred over an unknown format, even when the unknown format has a higher resolution.
requireUnmarkedFormat controls how uncertainty is handled:
| Setting | Result |
|---|---|
false (default) | Unknown formats are allowed and remain watermark_status: "unknown". A complete delivered result can be billed; this is not a guarantee of a watermark-free video. |
true | Only formats described as unmarked by the extractor are allowed. Unknown formats return partial / WATERMARK_NOT_CONFIRMED, with no result fee or delivered media link. |
When only marked MP4 formats are available, the result is partial / ONLY_WATERMARKED_FORMATS; no file is saved and no result fee is charged. Apify platform/proxy usage can still apply to these attempts.
watermark_status is present, not_reported or unknown. not_reported means extractor metadata explicitly indicates an unmarked format; it does not prove the absence of a logo in the pixels. watermark_checked_visually is always false: this Actor has no automatic visual watermark detector.
For workflows that cannot accept unknown formats, use:
{"urls": ["https://www.tiktok.com/@waffleskkw/video/7678161526284602644"],"downloadVideo": true,"requireUnmarkedFormat": true}
Strict mode may return no complete results when watermark metadata is unknown, including for the example URL above. It relies on format metadata, not visual detection; original captions and embedded creator branding remain.
Pricing
The Actor uses pay per event + platform usage. Result fees are:
| Mode | Per complete result | Per 1,000 complete results |
|---|---|---|
| Metadata + verified temporary MP4 link | $0.001 | $1 |
| Saved MP4 + metadata | $0.003 | $3 |
| Photo (slideshow) post + metadata (all photos saved, or verified in metadata mode) | free until November 27, 2026; then $0.003 | then $3 |
Saving the sound (downloadAudio) has no separate result fee. One result triggers only the fee for the selected mode. Failed, partial and duplicate results have no result fee. The pay per event + usage model also charges Apify platform usage separately, including resources consumed by failed requests and configured proxies. These result prices are not the total run cost. Check the active pricing in Apify Console/Store before starting a run.
The Actor stops processing new paid results when the result-event spending limit is reached. Under a usage-billed configuration, platform usage is separate from that limit.
Limits
TikTok can block requests or restrict availability by region. Optional proxies may improve access but incur costs and do not guarantee success. The Actor does not remove watermarks. Watermark handling and strict-mode limitations are described above. No account cookies or login are required from users.
Socket timeout is per network operation, not a total run deadline. Each file download also has a 60-second processing bound, checked between reads. Use 512 MB. For the default 600-second processing limit, set the Apify run timeout to at least 900 seconds so the last operation and output persistence can finish. An external timeout or forced abort can prevent the final summary from being written.
Batch controls and continuation
| Input | Default | Allowed | Purpose |
|---|---|---|---|
requestIntervalSecs | 3 | 1–30 | Minimum pause after a video attempt, before the next valid video. |
maxRunSecs | 600 | 30–3,600 | Soft processing limit checked before starting another video; an active network operation can overrun it. |
maxTotalVideoSizeMb | 250 | 1–1,000 | Total successful downloaded payload limit in MiB, including files whose storage delivery fails and duplicate short-link downloads. |
The size limit excludes probes, metadata, unsuccessful/partial transfers and platform overhead; it is not a total bandwidth or money cap. A file that exceeds the remaining batch allowance returns partial / RUN_SIZE_LIMIT, without a result fee, and stops the run. A file larger than its per-video limit returns VIDEO_TOO_LARGE.
The OUTPUT record includes schema_version, input_count, processed_count, duplicate_count, successful, partial, failed, charged_count, downloaded_bytes, elapsed_seconds, stop_reason, remaining_urls and retry_urls. processed_count counts dataset rows; skipped duplicates have no row.
To continue, create a new run with remaining_urls and the same options. retry_urls contains valid inputs that produced incomplete results; review their error codes before retrying. For RATE_LIMITED, defer the next run rather than immediately retrying. Unavailable, oversized or strict-watermark-rejected videos may remain incomplete on retry. Deduplication applies within a run only; resubmitting successful videos in another run can incur a new fee.
Stop reasons: BUDGET_LIMIT, RUN_TIME_LIMIT, RUN_SIZE_LIMIT, RATE_LIMITED, ACCESS_FAILURE_LIMIT, or null when the batch finishes. There is no automatic cross-run continuation or guaranteed exactly-once billing across crashes/resurrections. Each run has its own request pacing; concurrent runs can still encounter shared network limits.
Calling the API
Use your Apify token from an environment variable. Submit a run asynchronously, poll its status, then retrieve its dataset and summary. Avoid synchronous requests for large batches.
curl --fail-with-body -X POST \'https://api.apify.com/v2/acts/fyHpwU1X693apdSwT/runs?memory=512&timeout=900' \-H "Authorization: Bearer $APIFY_TOKEN" \-H 'Content-Type: application/json' \--data-binary @input.json
This request uses the Actor's configured default build. To pin a specific build, add the build query parameter. The response contains the run ID, defaultDatasetId and defaultKeyValueStoreId. Use GET /v2/actor-runs/{runId} to poll, GET /v2/datasets/{defaultDatasetId}/items?format=json for results, and GET /v2/key-value-stores/{defaultKeyValueStoreId}/records/OUTPUT for the summary, with the same authorization header. Check every dataset row: a successful platform run may still contain partial or error results.