explaingit

evil0ctal/douyin_tiktok_download_api

★ 17,831PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A self-hostable web API and browser tool for downloading TikTok, Douyin, and Bilibili videos without watermarks, usable via a browser interface or programmatically from your own app.

Mindmap

mindmap
  root((TikTok Download API))
    What it does
      Watermark-free downloads
      Multi-platform support
      API and web UI
    Tech stack
      Python
      FastAPI
      Docker
    Platforms
      TikTok
      Douyin
      Bilibili
    Use cases
      Video archiving
      iOS shortcuts
      Data analysis
    Deployment
      Docker
      Self-hosted server
      PyPI package
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Download a TikTok or Douyin video without the platform watermark for personal archiving.

USE CASE 2

Build an iOS shortcut that reads a video link from the clipboard and saves a clean, watermark-free file.

USE CASE 3

Integrate watermark-free video downloading into your own app by calling this project's REST API.

Tech stack

PythonFastAPIHTTPXPyWebIODocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Douyin session cookie to bypass anti-scraping protection when downloading from Douyin.

Free to use for any purpose including commercial use, as long as you include the license notice (Apache 2.0).

In plain English

This project is a high-performance, asynchronous API and web tool for downloading videos and images from Douyin (the Chinese version of TikTok), TikTok, and Bilibili without watermarks. It lets you paste a video link and get back the clean media file, or call it programmatically from your own application. The core problem it solves is that TikTok and Douyin embed watermarks into videos and do not offer direct download links through their normal interfaces. This tool bypasses that by fetching the raw media URLs through the platforms' web APIs, stripping the watermark, and returning the file for download. It is built in Python using FastAPI (a framework for building web APIs) and HTTPX (an asynchronous HTTP client), and includes a web interface built with PyWebIO so you can use it directly in a browser without writing any code. You can also deploy it on your own server via Docker or a one-click Linux script, or install it as a Python package and call its scraping functions directly in your own project. Practical uses listed in the README include downloading videos that are otherwise restricted, data analysis, and building iOS shortcut integrations that download videos by reading from the clipboard. Because the platforms use anti-scraping algorithms (called X-Bogus and A-Bogus in the README), self-hosted deployments need a session cookie from the Douyin website configured before use. The project is licensed under Apache 2.0 and is described as permanently free and open source. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Show me how to call the douyin_tiktok_download_api REST endpoint to download a TikTok video without a watermark and save it locally.
Prompt 2
Write a Python script using the douyin_tiktok_download_api scraper functions to batch download a list of Douyin video URLs.
Prompt 3
How do I configure a Douyin session cookie in douyin_tiktok_download_api to bypass the platform's anti-scraping protection?
Prompt 4
Deploy douyin_tiktok_download_api with Docker and expose it as a local API I can call from an iOS Shortcuts workflow.
Prompt 5
Use douyin_tiktok_download_api to download Bilibili videos and save them with their original titles.
Open on GitHub → Explain another repo

← evil0ctal on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.