Douyin_Spider is a web scraper and API client for the Douyin (TikTok China) platform that enables automated data collection and real-time interaction with the service.
The tool addresses the challenge of programmatically accessing Douyin's functionality by reverse-engineering its APIs and WebSocket protocols. It provides structured access to user profiles, video metadata, comments with nested replies, search across videos and users, follower lists, notifications, and recommendation feeds. For live streaming, it monitors chat messages, gifts with sender information, viewer joins, follows, likes, and room metrics, while also supporting sending messages and likes within live streams. The private messaging system uses WebSocket connections to receive messages in multiple formats including text, emojis, voice, images, and video shares, and allows sending messages and managing conversation lists. The tool also supports interactive operations like liking videos, posting and replying to comments, and managing saved content.
Developers considering adoption should understand this is a reverse-engineering project designed for automation scenarios where Douyin's official APIs are unavailable or insufficient. It suits developers building AI agents that need to monitor live streams, respond to private messages, or collect structured data from the platform. The project includes automatic retry logic, reconnection handling, proxy support, and structured output formats in JSON, Excel, and media files. The README emphasizes this is for learning and technical research only, with explicit warnings against using it for spreading harmful or illegal content.
The project maintains active engagement with its codebase through regular updates to handle Douyin's API changes. Development shows responsiveness to platform modifications and includes comprehensive error handling mechanisms. The tool demonstrates ongoing refinement of its core functionality across data collection, live streaming, and messaging subsystems.
