Douyin_TikTok_Download_API(抖音/TikTok API)

[English](./README.en.md) | [简体中文](./README.md) 🚀「Douyin_TikTok_Download_API」是一个开箱即用的高性能异步[抖音](https://www.douyin.com)|[TikTok](https://www.tiktok.com)|[Bilibili](https://www.bilibili.com)数据爬取工具，支持API调用，在线批量解析及下载。 [![GitHub license](https://img.shields.io/github/license/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square)](LICENSE) [![Release Version](https://img.shields.io/github/v/release/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square)](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/releases/latest) [![GitHub Star](https://img.shields.io/github/stars/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square)](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/stargazers) [![GitHub Fork](https://img.shields.io/github/forks/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square)](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/network/members) [![GitHub issues](https://img.shields.io/github/issues/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square)](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/issues) [![GitHub closed issues](https://img.shields.io/github/issues-closed/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square)](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/issues?q=is%3Aissue+is%3Aclosed) ![GitHub Repo size](https://img.shields.io/github/repo-size/Evil0ctal/Douyin_TikTok_Download_API?style=flat-square&color=3cb371)
[![PyPI v](https://img.shields.io/pypi/v/douyin-tiktok-scraper?style=flat-square&color=%23a8e6cf)](https://pypi.org/project/douyin-tiktok-scraper/) [![PyPI wheel](https://img.shields.io/pypi/wheel/douyin-tiktok-scraper?style=flat-square&color=%23dcedc1)](https://pypi.org/project/douyin-tiktok-scraper/#files) [![PyPI dm](https://img.shields.io/pypi/dm/douyin-tiktok-scraper?style=flat-square&color=%23ffd3b6)](https://pypi.org/project/douyin-tiktok-scraper/) [![PyPI pyversions](https://img.shields.io/pypi/pyversions/douyin-tiktok-scraper?color=%23ffaaa5&style=flat-square)](https://pypi.org/project/douyin-tiktok-scraper/)
[![API status](https://img.shields.io/website?down_color=lightgrey&label=API%20Status&down_message=API%20offline&style=flat-square&up_color=%23dfb9ff&up_message=online&url=https%3A%2F%2Fapi.douyin.wtf%2Fdocs)](https://api.douyin.wtf/docs) [![TikHub-API status](https://img.shields.io/website?down_color=lightgrey&label=TikHub-API%20Status&down_message=API%20offline&style=flat-square&up_color=%23dfb9ff&up_message=online&url=https%3A%2F%2Fapi.tikhub.io%2Fdocs)](https://api.tikhub.io/docs)
[![爱发电](https://img.shields.io/badge/爱发电-evil0ctal-blue.svg?style=flat-square&color=ea4aaa&logo=github-sponsors)](https://afdian.net/@evil0ctal) [![Kofi](https://img.shields.io/badge/Kofi-evil0ctal-orange.svg?style=flat-square&logo=kofi)](https://ko-fi.com/evil0ctal) [![Patreon](https://img.shields.io/badge/Patreon-evil0ctal-red.svg?style=flat-square&logo=patreon)](https://www.patreon.com/evil0ctal)
## 赞助商 这些赞助商已付费放置在这里，**Douyin_TikTok_Download_API** 项目将永远免费且开源。如果您希望成为该项目的赞助商，请查看我的 [GitHub 赞助商页面](https://github.com/sponsors/evil0ctal)。
TikHub.io - Global Social Data & API Marketplace

TikHub.io

Your Ultimate Social Media Data & API Marketplace

Professional data solutions for Douyin, Xiaohongshu, TikTok, Instagram, YouTube, Twitter, and more.
Real-time Data | Flexible APIs | Seamless Integration | Competitive Pricing with Discounts

Discover TikHub.io Marketplace
Buy and sell custom APIs, services, and social media solutions.
Join a thriving ecosystem of developers, businesses, and content creators.

Trusted by leading global influencer marketing and social media intelligence platforms

## 👻介绍 > 🚨如需使用私有服务器运行本项目，请参考：[部署准备工作](./README.md#%EF%B8%8F%E9%83%A8%E7%BD%B2%E5%89%8D%E7%9A%84%E5%87%86%E5%A4%87%E5%B7%A5%E4%BD%9C%E8%AF%B7%E4%BB%94%E7%BB%86%E9%98%85%E8%AF%BB), [Docker部署](./README.md#%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%E4%BA%8C-docker), [一键部署](./README.md#%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%E4%B8%80-linux) 本项目是基于 [PyWebIO](https://github.com/pywebio/PyWebIO)，[FastAPI](https://fastapi.tiangolo.com/)，[HTTPX](https://www.python-httpx.org/)，快速异步的[抖音](https://www.douyin.com/)/[TikTok](https://www.tiktok.com/)数据爬取工具，并通过Web端实现在线批量解析以及下载无水印视频或图集，数据爬取API，iOS快捷指令无水印下载等功能。你可以自己部署或改造本项目实现更多功能，也可以在你的项目中直接调用[scraper.py](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/Stable/scraper.py)或安装现有的[pip包](https://pypi.org/project/douyin-tiktok-scraper/)作为解析库轻松爬取数据等..... *一些简单的运用场景：* *下载禁止下载的视频，进行数据分析，iOS无水印下载（搭配[iOS自带的快捷指令APP](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334) 配合本项目API实现应用内下载或读取剪贴板下载）等.....* ## 🔊 V4 版本备注 - 感兴趣一起写这个项目的给请加微信`Evil0ctal`备注github项目重构，大家可以在群里互相交流学习，不允许发广告以及违法的东西，纯粹交朋友和技术交流。 - 本项目使用`X-Bogus`算法以及`A_Bogus`算法请求抖音和TikTok的Web API。 - 由于Douyin的风控，部署完本项目后请在**浏览器中获取Douyin网站的Cookie然后在config.yaml中进行替换。** - 请在提出issue之前先阅读下方的文档，大多数问题的解决方法都会包含在文档中。 - 本项目是完全免费的，但使用时请遵守：[Apache-2.0 license](https://github.com/Evil0ctal/Douyin_TikTok_Download_API?tab=Apache-2.0-1-ov-file#readme) ## 🔖TikHub.io API [TikHub.io](https://api.tikhub.io/)是一个API平台，提供包括Douyin、TikTok在内的各种公开数据接口，如果您想支持 [Douyin_TikTok_Download_API](https://github.com/Evil0ctal/Douyin_TikTok_Download_API) 项目的开发，我们强烈建议您选择[TikHub.io](https://api.tikhub.io/)。 #### 特点： > 📦 开箱即用 简化使用流程，利用封装好的SDK迅速开展开发工作。所有API接口均依据RESTful架构设计，并使用OpenAPI规范进行描述和文档化，附带示例参数，确保调用更加简便。 > 💰 成本优势 不预设套餐限制，没有月度使用门槛，所有消费按实际使用量即时计费，并且根据用户每日的请求量进行阶梯式计费，同时可以通过每日签到在用户后台进行签到获取免费的额度，并且这些免费额度不会过期。 > ⚡️ 快速支持 我们有一个庞大的Discord社区服务器，管理员和其他用户会在服务器中快速的回复你，帮助你快速解决当前的问题。 > 🎉 拥抱开源 TikHub的部分源代码会开源在Github上，并且会赞助一些开源项目的作者。 #### 链接： - Github: [TikHub Github](https://github.com/TikHubIO) - Discord: [TikHub Discord](https://discord.com/invite/aMEAS8Xsvz) - Register: [TikHub signup](https://beta-web.tikhub.io/en-us/users/signup) - API Docs: [TikHub API Docs](https://api.tikhub.io/) ## 🖥演示站点: 我很脆弱...请勿压测(·•᷄ࡇ•᷅ ） > 😾演示站点的在线下载功能已关闭，并且由于Cookie原因，Douyin的解析以及API服务在Demo站点无法保证可用性。 🍔Web APP: [https://douyin.wtf/](https://douyin.wtf/) 🍟API Document: [https://douyin.wtf/docs](https://douyin.wtf/docs) 🌭TikHub API Document: [https://api.tikhub.io/docs](https://api.tikhub.io/docs) 💾iOS Shortcut(快捷指令): [Shortcut release](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/discussions/104?sort=top) 📦️桌面端下载器(仓库推荐)： - [Johnserf-Seed/TikTokDownload](https://github.com/Johnserf-Seed/TikTokDownload) - [HFrost0/bilix](https://github.com/HFrost0/bilix) - [Tairraos/TikDown - [需更新]](https://github.com/Tairraos/TikDown/) ## ⚗️技术栈 * [/app/web](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/app/web) - [PyWebIO](https://www.pyweb.io/) * [/app/api](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/app/api) - [FastAPI](https://fastapi.tiangolo.com/) * [/crawlers](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/crawlers) - [HTTPX](https://www.python-httpx.org/) > ***/crawlers*** - 向不同平台的API提交请求并取回数据，处理后返回字典(dict)，支持异步。 > ***/app/api*** - 获得请求参数并使用`Crawlers`相关类处理数据后以JSON形式返回，视频下载，配合iOS快捷指令实现快速调用，支持异步。 > ***/app/web*** - 使用`PyWebIO`制作的简易Web程序，将网页输入的值进行处理后使用`Crawlers`相关类处理接口输出相关数据在网页上。 ***以上文件的参数大多可在对应的`config.yaml`中进行修改*** ## 💡项目文件结构 ``` ./Douyin_TikTok_Download_API ├─app │ ├─api │ │ ├─endpoints │ │ └─models │ ├─download │ └─web │ └─views └─crawlers ├─bilibili │ └─web ├─douyin │ └─web ├─hybrid ├─tiktok │ ├─app │ └─web └─utils ``` ## ✨支持功能： - 网页端批量解析(支持抖音/TikTok混合解析) - 在线下载视频或图集。 - 制作[pip包](https://pypi.org/project/douyin-tiktok-scraper/)方便快速导入你的项目 - [iOS快捷指令快速调用API](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334)实现应用内下载无水印视频/图集 - 完善的API文档([Demo/演示](https://api.douyin.wtf/docs)) - 丰富的API接口： - 抖音网页版API - [x] 视频数据解析 - [x] 获取用户主页作品数据 - [x] 获取用户主页喜欢作品数据 - [x] 获取用户主页收藏作品数据 - [x] 获取用户主页信息 - [x] 获取用户合辑作品数据 - [x] 获取用户直播流数据 - [x] 获取指定用户的直播流数据 - [x] 获取直播间送礼用户排行榜 - [x] 获取单个视频评论数据 - [x] 获取指定视频的评论回复数据 - [x] 生成msToken - [x] 生成verify_fp - [x] 生成s_v_web_id - [x] 使用接口网址生成X-Bogus参数 - [x] 使用接口网址生成A_Bogus参数 - [x] 提取单个用户id - [x] 提取列表用户id - [x] 提取单个作品id - [x] 提取列表作品id - [x] 提取列表直播间号 - [x] 提取列表直播间号 - TikTok网页版API - [x] 视频数据解析 - [x] 获取用户主页作品数据 - [x] 获取用户主页喜欢作品数据 - [x] 获取用户主页信息 - [x] 获取用户主页粉丝数据 - [x] 获取用户主页关注数据 - [x] 获取用户主页合辑作品数据 - [x] 获取用户主页搜藏数据 - [x] 获取用户主页播放列表数据 - [x] 获取单个视频评论数据 - [x] 获取指定视频的评论回复数据 - [x] 生成msToken - [x] 生成ttwid - [x] 使用接口网址生成X-Bogus参数 - [x] 提取单个用户sec_user_id - [x] 提取列表用户sec_user_id - [x] 提取单个作品id - [x] 提取列表作品id - [x] 获取用户unique_id - [x] 获取列表unique_id - 哔哩哔哩网页版API - [x] 获取单个视频详情信息 - [x] 获取视频流地址 - [x] 获取用户发布视频作品数据 - [x] 获取用户所有收藏夹信息 - [x] 获取指定收藏夹内视频数据 - [x] 获取指定用户的信息 - [x] 获取综合热门视频信息 - [x] 获取指定视频的评论 - [x] 获取视频下指定评论的回复 - [x] 获取指定用户动态 - [x] 获取视频实时弹幕 - [x] 获取指定直播间信息 - [x] 获取直播间视频流 - [x] 获取指定分区正在直播的主播 - [x] 获取所有直播分区列表 - [x] 通过bv号获得视频分p信息 --- ## 📦调用解析库（已废弃需要更新）: > 💡PyPi：[https://pypi.org/project/douyin-tiktok-scraper/](https://pypi.org/project/douyin-tiktok-scraper/) 安装解析库：`pip install douyin-tiktok-scraper` ```python import asyncio from douyin_tiktok_scraper.scraper import Scraper api = Scraper() async def hybrid_parsing(url: str) -> dict: # Hybrid parsing(Douyin/TikTok URL) result = await api.hybrid_parsing(url) print(f"The hybrid parsing result:\n {result}") return result asyncio.run(hybrid_parsing(url=input("Paste Douyin/TikTok/Bilibili share URL here: "))) ``` ## 🗺️支持的提交格式： > 💡提示：包含但不仅限于以下例子，如果遇到链接解析失败请开启一个新 [issue](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/issues) - 抖音分享口令 (APP内复制) ```text 7.43 pda:/ 让你在几秒钟之内记住我 https://v.douyin.com/L5pbfdP/ 复制此链接，打开Dou音搜索，直接观看视频！ ``` - 抖音短网址 (APP内复制) ```text https://v.douyin.com/L4FJNR3/ ``` - 抖音正常网址 (网页版复制) ```text https://www.douyin.com/video/6914948781100338440 ``` - 抖音发现页网址 (APP复制) ```text https://www.douyin.com/discover?modal_id=7069543727328398622 ``` - TikTok短网址 (APP内复制) ```text https://www.tiktok.com/t/ZTR9nDNWq/ ``` - TikTok正常网址 (网页版复制) ```text https://www.tiktok.com/@evil0ctal/video/7156033831819037994 ``` - 抖音/TikTok批量网址(无需使用符合隔开) ```text https://v.douyin.com/L4NpDJ6/ https://www.douyin.com/video/7126745726494821640 2.84 nqe:/ 骑白马的也可以是公主%%百万转场变身https://v.douyin.com/L4FJNR3/ 复制此链接，打开Dou音搜索，直接观看视频！ https://www.tiktok.com/t/ZTR9nkkmL/ https://www.tiktok.com/t/ZTR9nDNWq/ https://www.tiktok.com/@evil0ctal/video/7156033831819037994 ``` ## 🛰️API文档 ***API文档：*** 本地：[http://localhost/docs](http://localhost/docs) 在线：[https://api.douyin.wtf/docs](https://api.douyin.wtf/docs) ***API演示：*** - 爬取视频数据(TikTok或Douyin混合解析) `https://api.douyin.wtf/api/hybrid/video_data?url=[视频链接/Video URL]&minimal=false` - 下载视频/图集(TikTok或Douyin混合解析) `https://api.douyin.wtf/api/download?url=[视频链接/Video URL]&prefix=true&with_watermark=false` ***更多演示请查看文档内容......*** ## ⚠️部署前的准备工作(请仔细阅读)： - 你需要自行解决爬虫Cookie风控问题，否则可能会导致接口无法使用，修改完配置文件后需要重启服务才能生效，并且最好使用已经登录过的账号的Cookie。 - 抖音网页端Cookie（自行获取并替换下面配置文件中的Cookie）： - https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/30e56e5a7f97f87d60b1045befb1f6db147f8590/crawlers/douyin/web/config.yaml#L7 - TikTok网页端Cookie（自行获取并替换下面配置文件中的Cookie）： - https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/30e56e5a7f97f87d60b1045befb1f6db147f8590/crawlers/tiktok/web/config.yaml#L6 - 演示站点的在线下载功能被我关掉了，有人下的视频巨大无比直接给我服务器干崩了，你可以在网页解析结果页面右键保存视频... - 演示站点的Cookie是我自己的，不保证长期有效，只起到演示作用，自己部署的话请自行获取Cookie。 - 需要TikTok Web API返回的视频链接直接访问会发生HTTP 403错误，请使用本项目API中的`/api/download`接口对TikTok 视频进行下载，这个接口在演示站点中已经被手动关闭了，需要你自行部署本项目。 - 这里有一个**视频教程**可以参考：***[https://www.bilibili.com/video/BV1vE421j7NR/](https://www.bilibili.com/video/BV1vE421j7NR/)*** ## 💻部署(方式一 Linux) > 💡提示：最好将本项目部署至美国地区的服务器，否则可能会出现奇怪的BUG。 推荐大家使用[Digitalocean](https://www.digitalocean.com/)的服务器，因为可以白嫖。 使用我的邀请链接注册，你可以获得$200的credit，当你在上面消费$25时，我也可以获得$25的奖励。 我的邀请链接： [https://m.do.co/c/9f72a27dec35](https://m.do.co/c/9f72a27dec35) > 使用脚本一键部署本项目 - 本项目提供了一键部署脚本，可以在服务器上快速部署本项目。 - 脚本是在Ubuntu 20.04 LTS上测试的，其他系统可能会有问题，如果有问题请自行解决。 - 使用wget命令下载[install.sh](https://raw.githubusercontent.com/Evil0ctal/Douyin_TikTok_Download_API/main/bash/install.sh)至服务器并运行 ``` wget -O install.sh https://raw.githubusercontent.com/Evil0ctal/Douyin_TikTok_Download_API/main/bash/install.sh && sudo bash install.sh ``` > 开启/停止服务 - 使用以下命令来控制服务的运行或停止： - `sudo systemctl start Douyin_TikTok_Download_API.service` - `sudo systemctl stop Douyin_TikTok_Download_API.service` > 开启/关闭开机自动运行 - 使用以下命令来设置服务开机自动运行或取消开机自动运行： - `sudo systemctl enable Douyin_TikTok_Download_API.service` - `sudo systemctl disable Douyin_TikTok_Download_API.service` > 更新项目 - 项目更新时，确保更新脚本在虚拟环境中执行，更新所有依赖。进入项目bash目录并运行update.sh： - `cd /www/wwwroot/Douyin_TikTok_Download_API/bash && sudo bash update.sh` ## 💽部署(方式二 Docker) > 💡提示：Docker部署是最简单的部署方式，适合不熟悉Linux的用户，这种方法适合保证环境一致性、隔离性和快速设置。 > 请使用能正常访问Douyin或TikTok的服务器，否则可能会出现奇怪的BUG。 ### 准备工作 开始之前，请确保您的系统已安装Docker。如果还未安装Docker，可以从[Docker官方网站](https://www.docker.com/products/docker-desktop/)下载并安装。 ### 步骤1：拉取Docker镜像 首先，从Docker Hub拉取最新的Douyin_TikTok_Download_API镜像。 ```bash docker pull evil0ctal/douyin_tiktok_download_api:latest ``` 如果需要，可以替换`latest`为你需要部署的具体版本标签。 ### 步骤2：运行Docker容器 拉取镜像后，您可以从此镜像启动一个容器。以下是运行容器的命令，包括基本配置： ```bash docker run -d --name douyin_tiktok_api -p 80:80 evil0ctal/douyin_tiktok_download_api ``` 这个命令的每个部分作用如下： * `-d`：在后台运行容器（分离模式）。 * `--name douyin_tiktok_api `：将容器命名为`douyin_tiktok_api `。 * `-p 80:80`：将主机上的80端口映射到容器的80端口。根据您的配置或端口可用性调整端口号。 * `evil0ctal/douyin_tiktok_download_api`：要使用的Docker镜像名称。 ### 步骤3：验证容器是否运行 使用以下命令检查您的容器是否正在运行： ```bash docker ps ``` 这将列出所有活动容器。查找`douyin_tiktok_api `以确认其正常运行。 ### 步骤4：访问应用程序 容器运行后，您应该能够通过`http://localhost`或API客户端访问Douyin_TikTok_Download_API。如果配置了不同的端口或从远程位置访问，请调整URL。 ### 可选：自定义Docker命令 对于更高级的部署，您可能希望自定义Docker命令，包括环境变量、持久数据的卷挂载或其他Docker参数。这是一个示例： ```bash docker run -d --name douyin_tiktok_api -p 80:80 \ -v /path/to/your/data:/data \ -e MY_ENV_VAR=my_value \ evil0ctal/douyin_tiktok_download_api ``` * `-v /path/to/your/data:/data`：将主机上的`/path/to/your/data`目录挂载到容器的`/data`目录，用于持久化或共享数据。 * `-e MY_ENV_VAR=my_value`：在容器内设置环境变量`MY_ENV_VAR`，其值为`my_value`。 ### 配置文件修改 项目的大部分配置可以在以下几个目录中的`config.yaml`文件进行修改： * `/crawlers/douyin/web/config.yaml` * `/crawlers/tiktok/web/config.yaml` * `/crawlers/tiktok/app/config.yaml` ### 步骤5：停止并移除容器 需要停止和移除容器时，使用以下命令： ```bash # Stop docker stop douyin_tiktok_api # Remove docker rm douyin_tiktok_api ``` ## 📸截图 ***API速度测试(对比官方API)***
🔎点击展开截图 抖音官方API: ![](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/Screenshots/benchmarks/Douyin_API.png?raw=true) 本项目API: ![](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/Screenshots/benchmarks/Douyin_API_Douyin_wtf.png?raw=true) TikTok官方API: ![](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/Screenshots/benchmarks/TikTok_API.png?raw=true) 本项目API: ![](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/Screenshots/benchmarks/TikTok_API_Douyin_wtf.png?raw=true)
***项目界面***
🔎点击展开截图 Web主界面: ![](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/Screenshots/v3_screenshots/Home.png?raw=true) Web main interface: ![](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/Screenshots/v3_screenshots/Home_en.png?raw=true)
## 📜 Star历史 [![Star History Chart](https://api.star-history.com/svg?repos=Evil0ctal/Douyin_TikTok_Download_API&type=Timeline)](https://star-history.com/#Evil0ctal/Douyin_TikTok_Download_API&Timeline) [Apache-2.0 license](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/Stable/LICENSE) > Start: 2021/11/06 > GitHub: [@Evil0ctal](https://github.com/Evil0ctal)