mirror of
https://github.com/Evil0ctal/Douyin_TikTok_Download_API.git
synced 2025-04-23 05:24:26 +08:00
413 lines
14 KiB
Markdown
413 lines
14 KiB
Markdown
# welcome`TikTokDownloader_PyWebIO`(Douyin online analysis)
|
||
|
||
[](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/LICENSE)[](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/issues)[](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/network)[](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/stargazers)
|
||
|
||
content:[API](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO#%EF%B8%8Fapi%E4%BD%BF%E7%94%A8)[screenshot](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO#%E6%88%AA%E5%9B%BE)[deploy](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO#%E9%83%A8%E7%BD%B2)
|
||
|
||
Language: \[[English](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/README.en.md)] \[[Simplified Chinese](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/README.md)]
|
||
|
||
> Note: Words "TikTok" in this readme file mentioned stands for the Chinese version of TikTok.
|
||
> AKA \[[douin](https://www.douyin.com/)] or \[[Tik Tok](https://www.douyin.com/)] , The US TikTok is now supported! (no gallery analysis function)
|
||
|
||
## 👻Introduction
|
||
|
||
🚀Demo address:<https://douyin.wtf/>
|
||
|
||
🛰API demo:<https://douyin.wtf/api?url=https://v.douyin.com/R9bQKx4/>
|
||
|
||
This project uses[PyWebIO](https://github.com/pywebio/PyWebIO)、[Requests](https://github.com/psf/requests)、[Flask](https://github.com/pallets/flask), using Python to implement online batch parsing of Douyin's watermark-free video/atlas.
|
||
|
||
It can be used to download videos that the author prohibits to download, and can be used with[iOS Shortcuts APP](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334)配合本项目API实现应用内下载。
|
||
|
||
## 💯 Supported features:
|
||
|
||
- Support Douyin video/atlas parsing
|
||
|
||
- Support overseas TikTok video analysis (no atlas analysis)
|
||
|
||
- Support batch parsing (support Douyin/TikTok hybrid parsing)
|
||
|
||
- Support API calls
|
||
|
||
* * *
|
||
|
||
## 🤦♂️Follow-up features:
|
||
|
||
- [ ] match[iOS Shortcuts APP](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334)Realize in-app downloads (lazy, come and write for help)
|
||
|
||
* * *
|
||
|
||
## 🧭How to use:
|
||
|
||
- Install dependent libraries:
|
||
|
||
```text
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
- Run TikTok_ZH.py (Python version 3.9 or above)
|
||
|
||
```text
|
||
python3 TikTok_ZH.py
|
||
# python3 TikTok_EN.py - English interface
|
||
```
|
||
|
||
- go to homepage
|
||
|
||
```text
|
||
http://localhost(服务器IP):80/
|
||
```
|
||
|
||
## 🗺️ Supported submission formats:
|
||
|
||
- share password
|
||
|
||
```text
|
||
例子：7.43 pda:/ 让你在几秒钟之内记住我 https://v.douyin.com/L5pbfdP/ 复制此链接，打开Dou音搜索，直接观看视频！
|
||
```
|
||
|
||
- Short URL
|
||
|
||
```text
|
||
例子：https://v.douyin.com/RHnWEng/
|
||
```
|
||
|
||
- normal url
|
||
|
||
```text
|
||
例子：
|
||
https://www.douyin.com/video/6914948781100338440
|
||
```
|
||
|
||
- TikTok URL
|
||
|
||
```text
|
||
例子：
|
||
https://www.tiktok.com/@tvamii/video/7045537727743380782
|
||
```
|
||
|
||
- Douyin/TikTok bulk URLs (no need to separate them)
|
||
|
||
```text
|
||
例子：
|
||
https://v.douyin.com/L5psQFx/
|
||
https://v.douyin.com/L5psdyX/
|
||
https://v.douyin.com/L5pbfdP/
|
||
https://www.tiktok.com/@gamer/video/7054061777033628934
|
||
https://www.tiktok.com/@off.anime_rei/video/7059609659690339586
|
||
https://www.tiktok.com/@tvamii/video/7045537727743380782
|
||
```
|
||
|
||
## 🛰️API usage
|
||
|
||
The API can convert the request parameters into a watermark-free video/picture straight link that needs to be extracted, and can be downloaded in-app with the IOS shortcut.
|
||
|
||
- Parse request parameters
|
||
|
||
```text
|
||
http://localhost(服务器IP):80/api?url="复制的(抖音/TikTok)的(分享文本/链接)"
|
||
```
|
||
|
||
- return parameter
|
||
|
||
> Douyin video
|
||
|
||
```json
|
||
{
|
||
"Status": "Success",
|
||
"Type": "Video",
|
||
"video_author": "花花花菜",
|
||
"video_author_id": "Wobukunxixi",
|
||
"video_music": "https://sf3-cdn-tos.douyinstatic.com/obj/ies-music/6906830659719383822.mp3",
|
||
"video_title": "~猫跟你都想了解",
|
||
"video_url": "https://v3-dy-o.zjcdn.com/93e3a68e365ae83f4ce2b2bb9c253489/6191c9c3/video/tos/cn/tos-cn-ve-15/083012c589c842e69f5267803eb8e3a5/?a=1128&br=2262&bt=2262&cd=0%7C0%7C0&ch=96&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=StecAhgM6BMM8b8NDtPDWodpeaQ&l=202111150945070102121380392D1AC2F5&lr=all&mime_type=video_mp4&net=0&pl=0&qs=0&rc=ajh5aTRseW95eTMzNGkzM0ApNjk1OTU6OWVlN2Q7ODo0N2cpaHV2fWVuZDFwekBvbTJjMDVrbmBfLS1eLS9zczRhXi9iLmFgYGBfLy1iLi46Y29zYlxmK2BtYmJeYA%3D%3D&vl=&vr="
|
||
}
|
||
```
|
||
|
||
> Douyin Atlas
|
||
|
||
```json
|
||
{
|
||
"Status": "Success",
|
||
"Type": "Image",
|
||
"image_author": "三石壁纸(收徒)",
|
||
"image_author_id": "782972562",
|
||
"image_music": "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/635efafc32694ffbb73fbe60eca4a99d",
|
||
"image_title": "#壁纸 #炫酷壁纸 #图集 每一张都是精选",
|
||
"image_url": [
|
||
"https://p3-sign.douyinpic.com/tos-cn-i-0813/4af91199ca154074a8a5a63c3c749c6f~noop.webp?x-expires=1639530000&x-signature=P446eJEt2yuyhf2yb58Be29UpBA%3D&from=4257465056&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sh=&sc=&l=202111150954330102120702320620C75E&biz_tag=aweme_images"
|
||
]
|
||
}
|
||
```
|
||
|
||
> TikTok videos
|
||
|
||
```JSON
|
||
{
|
||
"author": {
|
||
"avatarLarger": "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ff448b093c20a2aa795fd4853717e020~c5_1080x1080.jpeg?x-expires=1640656800&x-signature=5Rh8sQDcLIC8JGjKOy9oSJkl7j8%3D",
|
||
"avatarMedium": "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ff448b093c20a2aa795fd4853717e020~c5_720x720.jpeg?x-expires=1640656800&x-signature=yxo2S9xC%2BIuwU03ewiatMm7%2FL%2Bg%3D",
|
||
"avatarThumb": "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ff448b093c20a2aa795fd4853717e020~c5_100x100.jpeg?x-expires=1640656800&x-signature=0wgx0hbDBPOZyfFg0Vb99N8nPbY%3D",
|
||
"commentSetting": 0,
|
||
"createTime": 1601316992,
|
||
"duetSetting": 0,
|
||
"ftc": false,
|
||
"id": "6877603649523090437",
|
||
"isADVirtual": false,
|
||
"nickname": "Marly Esteves",
|
||
"openFavorite": false,
|
||
"privateAccount": false,
|
||
"relation": 0,
|
||
"roomId": "",
|
||
"secUid": "MS4wLjABAAAAm8JPlXZV2ZZgmIlU4G9DrlTlUwGehheHwbYPrbPRABYE9WMm1vQeC-mDoSMI2C1V",
|
||
"secret": false,
|
||
"shortId": "",
|
||
"signature": "\ud83c\uddfa\ud83c\uddf8\ud83c\uddf2\ud83c\uddfd \ud83d\udcaa: gymnast\nBusiness inquiries: eric@undercurrent.net",
|
||
"stitchSetting": 0,
|
||
"uniqueId": "marlyestevess",
|
||
"verified": false
|
||
},
|
||
"authorStats": {
|
||
"diggCount": 8795,
|
||
"followerCount": 5700000,
|
||
"followingCount": 121,
|
||
"heart": 103800000,
|
||
"heartCount": 103800000,
|
||
"videoCount": 135
|
||
},
|
||
"challenges": [
|
||
{
|
||
"coverLarger": "",
|
||
"coverMedium": "",
|
||
"coverThumb": "",
|
||
"desc": "",
|
||
"id": "229207",
|
||
"isCommerce": false,
|
||
"profileLarger": "",
|
||
"profileMedium": "",
|
||
"profileThumb": "",
|
||
"title": "fyp"
|
||
},
|
||
{
|
||
"coverLarger": "",
|
||
"coverMedium": "",
|
||
"coverThumb": "",
|
||
"desc": "",
|
||
"id": "88764338",
|
||
"isCommerce": false,
|
||
"profileLarger": "",
|
||
"profileMedium": "",
|
||
"profileThumb": "",
|
||
"title": "foryoupage"
|
||
}
|
||
],
|
||
"comments": [
|
||
|
||
],
|
||
"createTime": 1638994283,
|
||
"desc": "#fyp #foryoupage",
|
||
"digged": false,
|
||
"diversificationLabels": [
|
||
"Finger Dance & Basic Dance",
|
||
"Singing & Dancing",
|
||
"Talents"
|
||
],
|
||
"duetDisplay": 0,
|
||
"duetEnabled": true,
|
||
"duetInfo": {
|
||
"duetFromId": "0"
|
||
},
|
||
"effectStickers": [
|
||
|
||
],
|
||
"forFriend": false,
|
||
"id": "7039426841836293382",
|
||
"indexEnabled": true,
|
||
"isActivityItem": false,
|
||
"isAd": false,
|
||
"itemCommentStatus": 0,
|
||
"itemMute": false,
|
||
"music": {
|
||
"album": "",
|
||
"authorName": "Nlvxa",
|
||
"coverLarge": "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/1249927df0a2a373179340a78e394614~c5_1080x1080.jpeg?x-expires=1640656800&x-signature=wMVnPmJ%2Fc9tGihTB5gX1ZWIz2AQ%3D",
|
||
"coverMedium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/1249927df0a2a373179340a78e394614~c5_720x720.jpeg?x-expires=1640656800&x-signature=j3ph02svrNf8puHIQ0NSVHs2iEk%3D",
|
||
"coverThumb": "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/1249927df0a2a373179340a78e394614~c5_100x100.jpeg?x-expires=1640656800&x-signature=l4CuW8jAzbHuZu3uD5tWkeFdZ2Q%3D",
|
||
"duration": 14,
|
||
"id": "7002377342848928518",
|
||
"original": true,
|
||
"playUrl": "https://sf16-ies-music-va.tiktokcdn.com/obj/musically-maliva-obj/7002377419353361157.mp3",
|
||
"scheduleSearchTime": 0,
|
||
"title": "som original"
|
||
},
|
||
"officalItem": false,
|
||
"originalItem": false,
|
||
"privateItem": false,
|
||
"scheduleTime": 0,
|
||
"secret": false,
|
||
"shareEnabled": true,
|
||
"showNotPass": false,
|
||
"stats": {
|
||
"commentCount": 21900,
|
||
"diggCount": 817800,
|
||
"playCount": 10600000,
|
||
"shareCount": 26100
|
||
},
|
||
"stickersOnItem": [
|
||
|
||
],
|
||
"stitchDisplay": 0,
|
||
"stitchEnabled": true,
|
||
"takeDown": 0,
|
||
"textExtra": [
|
||
{
|
||
"awemeId": "",
|
||
"end": 4,
|
||
"hashtagId": "229207",
|
||
"hashtagName": "fyp",
|
||
"isCommerce": false,
|
||
"secUid": "",
|
||
"start": 0,
|
||
"subType": 0,
|
||
"type": 1,
|
||
"userId": "",
|
||
"userUniqueId": ""
|
||
},
|
||
{
|
||
"awemeId": "",
|
||
"end": 16,
|
||
"hashtagId": "88764338",
|
||
"hashtagName": "foryoupage",
|
||
"isCommerce": false,
|
||
"secUid": "",
|
||
"start": 5,
|
||
"subType": 0,
|
||
"type": 1,
|
||
"userId": "",
|
||
"userUniqueId": ""
|
||
}
|
||
],
|
||
"video": {
|
||
"bitrate": 1460722,
|
||
"codecType": "h264",
|
||
"cover": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/25f1c8cbe324485a9150ee2cde4392bf_1638994284?x-expires=1640592000&x-signature=B%2BOuvSjwDvGugndVSIR1MPMWwUU%3D",
|
||
"definition": "720p",
|
||
"downloadAddr": "https://v16-webapp.tiktok.com/b709d6e41ef1241937d71f90a61d936a/61c97cfc/video/tos/useast2a/tos-useast2a-ve-0068c004/43ecb1ef5ade498c8410dc445ab19e95/?a=1988&br=2852&bt=1426&cd=0%7C0%7C1&ch=0&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=Yu12_FGgkag3-I&l=2021122702443001022308614803C088EC&lr=tiktok_m&mime_type=video_mp4&net=0&pl=0&qs=0&rc=M3VqZGc6ZjVrOTMzNzczM0ApNmRlZjdoZ2Q3NzRpNDQ5ZGdfZF41cjRfL2xgLS1kMTZzczNeLjA1YDBhYV5gYjYuLy46Yw%3D%3D&vl=&vr=",
|
||
"duration": 14,
|
||
"dynamicCover": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/d10c033594704158b6aca4322e58be14_1638994286?x-expires=1640592000&x-signature=WbcLzIP4FQxuIj822ZMggr%2Fil44%3D",
|
||
"encodeUserTag": "",
|
||
"encodedType": "normal",
|
||
"format": "mp4",
|
||
"height": 1024,
|
||
"id": "7039426841836293382",
|
||
"originCover": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/cc9f9229d57e47de90333cc69511678d_1638994284?x-expires=1640592000&x-signature=8LBqglI9RfwJpHRWABah6OJK2Io%3D",
|
||
"playAddr": "https://v16-webapp.tiktok.com/b709d6e41ef1241937d71f90a61d936a/61c97cfc/video/tos/useast2a/tos-useast2a-ve-0068c004/43ecb1ef5ade498c8410dc445ab19e95/?a=1988&br=2852&bt=1426&cd=0%7C0%7C1&ch=0&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=Yu12_FGgkag3-I&l=2021122702443001022308614803C088EC&lr=tiktok_m&mime_type=video_mp4&net=0&pl=0&qs=0&rc=M3VqZGc6ZjVrOTMzNzczM0ApNmRlZjdoZ2Q3NzRpNDQ5ZGdfZF41cjRfL2xgLS1kMTZzczNeLjA1YDBhYV5gYjYuLy46Yw%3D%3D&vl=&vr=",
|
||
"ratio": "720p",
|
||
"reflowCover": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/efd46a8a5fd7d02b6b42c75abf5a421b?x-expires=1640592000&x-signature=MDgKJs4%2F7Em8jawsTUpm7oh4%2BIg%3D",
|
||
"shareCover": [
|
||
"",
|
||
"https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/cc9f9229d57e47de90333cc69511678d_1638994284~tplv-tiktok-play.jpeg?x-expires=1640592000&x-signature=fNtmK8o0MzwJZMW2eSJBBKaxupk%3D",
|
||
"https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/cc9f9229d57e47de90333cc69511678d_1638994284~tplv-tiktokx-share-play.jpeg?x-expires=1640592000&x-signature=kYe2uG8PPjjIcJ7TEg5xaPW9aj0%3D"
|
||
],
|
||
"videoQuality": "normal",
|
||
"width": 576
|
||
},
|
||
"vl1": false,
|
||
"warnInfo": [
|
||
|
||
]
|
||
}
|
||
```
|
||
|
||
- Download video request parameters
|
||
|
||
```text
|
||
http://localhost(服务器IP):80/download_video?url="复制的抖音链接"
|
||
#返回mp4文件
|
||
```
|
||
|
||
- Download audio request parameters
|
||
|
||
```text
|
||
http://localhost(服务器IP):80/download_bgm?url="复制的抖音链接"
|
||
#返回mp3文件
|
||
```
|
||
|
||
* * *
|
||
|
||
## 💾Deploy
|
||
|
||
> It is best to deploy this project to an overseas server, otherwise strange problems may occur
|
||
|
||
For example: the project is deployed on a domestic server, and the person is in the United States, click the link of the result page and report an error 403, which is visually related to Douyin CDN.
|
||
|
||
> Deploy using the Pagoda Linux panel
|
||
|
||
- First go to the security group to open port 80 (default 80, which can be modified at the bottom of the file.)
|
||
|
||
- Search for python in the pagoda app store and install the project manager
|
||
|
||
|
||
|
||
* * *
|
||
|
||
- Create a project with an arbitrary name
|
||
|
||
- Path select the path where you upload the file
|
||
|
||
- The Python version needs to be at least 3.9 or above (install it by yourself in the version management on the left)
|
||
|
||
- The frame is modified to`Flask`
|
||
|
||
- The startup method is changed to`python`
|
||
|
||
- Startup file selection`TikTok_ZH.py`
|
||
|
||
- Check install module dependencies
|
||
|
||
- Start at will
|
||
|
||
- If the pagoda is installed`Nginx`wait for the application to stop it or`TikTok_ZH.py`Modify the port at the bottom (the default port is 80)
|
||
|
||
|
||
|
||
* * *
|
||
|
||
## 🎉 Screenshot
|
||
|
||
- Main interface
|
||
|
||
|
||
|
||
* * *
|
||
|
||
- parsing complete
|
||
|
||
> single
|
||
|
||
|
||
|
||
* * *
|
||
|
||
> batch
|
||
|
||
|
||
|
||
* * *
|
||
|
||
- API submit/return
|
||
|
||
> Video return value
|
||
|
||
|
||
|
||
> Atlas return value
|
||
|
||
|
||
|
||
> TikTok return value
|
||
|
||
|
||
|
||
* * *
|