Watermark-Free Douyin Video Download and Transcript Extraction

Feature Overview

• Get Download Link: Parse the direct download address of watermark-free videos from Douyin share links (no API key required)
• Download Video: Download watermark-free videos to a specified local directory
• Extract Transcript: Extract text content from videos through speech recognition (requires SiliconFlow API key)
• Auto-Save: Transcripts of each video are automatically saved to an independent folder (folder name is the video ID)

Environment Requirements

Dependency Installation

pip install requests ffmpeg-python

System Requirements

• FFmpeg must be installed on the system (for audio and video processing)
• macOS:

  brew install ffmpeg

• Ubuntu:

  apt install ffmpeg

API Key Configuration (Only required for transcript extraction)

export API_KEY="your-siliconflow-api-key"

Usage

Method 1: Use the Script (Recommended)

# Get video information and download link (no API key required)
python douyin_downloader.py --link "Douyin share link" --action info

# Download video to specified directory
python douyin_downloader.py --link "Douyin share link" --action download --output ./videos

# Extract video transcript and save to file (requires API_KEY environment variable)
python douyin_downloader.py --link "Douyin share link" --action extract --output ./output

# Extract transcript and save video at the same time
python douyin_downloader.py --link "Douyin share link" --action extract --output ./output --save-video

# Quiet mode (reduce output)
python douyin_downloader.py --link "Douyin share link" --action extract --output ./output --quiet

Output Directory Structure

output/
├── 7600361826030865707/      # Folder name is video ID
│   └── transcript.md         # Markdown format transcript file
├── 7581044356631612699/
│   ├── transcript.md
│   └── 7581044356631612699.mp4  # Saved when using --save-video
└── ...

Markdown Transcript Format

# Video Title

| Attribute | Value |
|------|-----|
| Video ID | `7600361826030865707` |
| Extraction Time | 2026-01-30 14:19:00 |
| Download Link | [Click to download](url) |

---

## Transcript Content

(Speech recognition text content)

Method 2: Call in Python Code

from douyin_downloader import get_video_info, download_video, extract_text

# Get video information
info = get_video_info("Douyin share link")
print(f"Video ID: {info['video_id']}")
print(f"Title: {info['title']}")
print(f"Download Link: {info['url']}")

# Download video
video_path = download_video("Douyin share link", output_dir="./videos")

# Extract transcript and save to file
result = extract_text("Douyin share link", output_dir="./output")
print(f"Transcript saved to: {result['output_path']}")
print(result['text'])

Workflow

Get Video Information

1. Parse Douyin share link to extract the actual video URL
2. Simulate mobile request to get page data
3. Extract watermark-free video address from page JSON data
4. Return video ID, title and download link

Extract Video Transcript

1. Parse share link to get video information
2. Download video to temporary directory
3. Use FFmpeg to extract audio from video (MP3 format)
4. Call SiliconFlow SenseVoice API for speech recognition
5. Clean up temporary files and return recognized text

FAQs

Failed to Parse Link

• Ensure the link is a valid Douyin share link
• Link format is usually

  https://v.douyin.com/xxxxx/

  or a full Douyin video URL

Failed to Extract Transcript

• Check if the

  API_KEY

  environment variable is set
• Ensure the API key is valid and has sufficient quota
• Ensure FFmpeg is installed correctly

Slow Download Speed

• This depends on network conditions and video size
• The script will display download progress

Notes

• This tool is for learning and research purposes only
• Comply with relevant laws and regulations when using
• Do not use it for any copyright infringement or illegal purposes