Skip to main content

Tok-DL: A TikTok Downloader that actually works

PyPI version

Features

  • Saves both video and gallery posts, including all of their metadata
  • Highest quality, no watermarks
  • Caches already-downloaded and unavailable posts to avoid fetching them again

Installation

pip install tok-dl

Usage

Tok-DL takes input in the form of newline-separated links. This format is the same as is contained in TikTok personal data downloads. It will ignore commented lines.

Usage: tok-dl [OPTIONS] INPUT_FILE

  TikTok Archiver

Options:
  -m, --metadata-only     Only download metadata.
  -o, --out DIRECTORY     Output directory. (default ./tiktok)
  -e, --errors-file FILE  File to save errors to. (default ./errors.log)
  --no-cache              Bypass the bad URL cache.
  --help                  Show this message and exit.

Limitations

  • Since Tok-DL utilizes the TiKWM API, there is a limit of 5,000 requests per day, and 1 per second. Tok-DL automatically handles this on a second-by-second basis, but you will begin seeing errors if you hit the daily limit. Thankfully, you can easily pick up where you left off by feeding errors.log back in to Tok-DL as an input file.

Metadata

Release files for tok-dl 0.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tok-dl 0.0.4
File Size Uploaded
tok_dl-0.0.4.tar.gz 40.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tok-dl 0.0.4
File Interpreter ABI Platform
tok_dl-0.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 69.9 kB

Release files / tok_dl-0.0.4.tar.gz

Download URL tok_dl-0.0.4.tar.gz
Size 40.8 kB
Tags Source
SHA-256 checksum
How to use checksums
7ff760f304d4e9efca211f261d89c3258c09fa6eaa2b19148a65402f81d00a92
BLAKE2b-256 checksum
How to use checksums
53954baeda6dc2d77d8fcb601d7b27e5cd95d9d6187eca239572b1837475274b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.22

Release files / tok_dl-0.0.4-py3-none-any.whl

Download URL tok_dl-0.0.4-py3-none-any.whl
Size 29.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
490e6663fcb147329a13854192e675138c22f13b8b6437d8b480eba21b3468a9
BLAKE2b-256 checksum
How to use checksums
d02a0b765fa26bed51ae540d12b47f9c802828d8c598920ec238d6ccd3a1f9dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.22

Release history Release notifications | RSS feed

This release

0.0.4 This release

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page