tiktok_download

Run the tikhub_independent.py script with the one command followed by the share URL. It calls the TikHub API to fetch video metadata, downloads the MP4, and prints metrics like likes, comments, and play counts.

Place one URL per line in a text file and run the batch subcommand. Downloads run concurrently with up to 10 worker threads, and each result reports success, saved path, and metrics.

Yes, a valid paid TikHub API key from tikhub.io is mandatory. Without it, the script stops immediately and instructs the user to obtain and configure a key before any download or data fetching occurs.

The downloader requires only the httpx Python package. The post-processing script that generates CSV and simplified JSON summaries uses only the Python standard library, so no extra packages are needed for it.

A 401 or 403 response means the API key is invalid or lacks required scopes. Verify the key configured in the skill, and for 429 rate limits reduce the max-workers setting or retry later.

It only supports the fetch_one_video_by_share_url endpoint, so user-profile crawling, image carousels, and non-URL workflows are excluded. Private or removed videos fail parsing, and mainland TikTok access may require a proxy.