# 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:
🛰API demo:
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)Cooperate with this project API to realize in-app download.
## 💯 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
* * *