mirror of
https://github.com/Evil0ctal/Douyin_TikTok_Download_API.git
synced 2025-04-23 06:04:22 +08:00
docs: Added README."en".md translation via https://github.com/dephraiim/translate-readme
This commit is contained in:
github-actions[bot]
parent
6c79347ca9
commit
c1333bb5da
414
README.en.md
Normal file
414
README.en.md
Normal file
@ -0,0 +1,414 @@
|
||||
# welcome`TikTokDownloader_PyWebIO`(Vibrato 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 \[[dou in](https://www.douyin.com/)] or \[[Tik Tok](https://www.douyin.com/)] , The US TikTok is now supported! (no gallery analysis function)
|
||||
|
||||
## 👻Introduction
|
||||
|
||||
🚀Demonstration 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), Use Python to realize online batch analysis of Douyin's watermarkless video/atlas.
|
||||
|
||||
Can be used to download videos that the author prohibits downloading, and can be used with[iOS Shortcut APP](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334)Cooperate with this project's API to realize in-app download.
|
||||
|
||||
## 💯Supported functions:
|
||||
|
||||
- Support Douyin video/atlas analysis
|
||||
|
||||
- Support overseas TikTok video analysis (no atlas analysis)
|
||||
|
||||
- Support batch analysis (support Douyin/TikTok mixed analysis)
|
||||
|
||||
- Support API call
|
||||
|
||||
* * *
|
||||
|
||||
## 🤦♂️Follow-up features:
|
||||
|
||||
- [ ] Collocation[iOS Shortcut APP](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334)Achieve in-app download (lazy, let me write it personally)
|
||||
|
||||
* * *
|
||||
|
||||
## 🧭How to use:
|
||||
|
||||
- Install dependent libraries:
|
||||
|
||||
```text
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
- Run TikTok_ZH.py (Python version needs to be above 3.9)
|
||||
|
||||
```text
|
||||
python3 TikTok_ZH.py
|
||||
# python3 TikTok_EN.py - English interface
|
||||
```
|
||||
|
||||
- Go to the homepage
|
||||
|
||||
```text
|
||||
http://localhost(服务器IP):80/
|
||||
```
|
||||
|
||||
## 🗺️Supported submission format:
|
||||
|
||||
- Share password
|
||||
|
||||
```text
|
||||
例子：8.79 vSy:/ %壁纸 %炫酷壁纸 %图集 每一张都是精选 https://v.douyin.com/RH7Gvmr/复淛佌lian接，打开Dou音搜索，直接观kan视频！
|
||||
```
|
||||
|
||||
- Short URL
|
||||
|
||||
```text
|
||||
例子：https://v.douyin.com/RHnWEng/
|
||||
```
|
||||
|
||||
- Normal URL
|
||||
|
||||
```text
|
||||
例子：
|
||||
https://www.douyin.com/video/6997729432244866341&previous_page=video_detail
|
||||
```
|
||||
|
||||
- TikTok URL
|
||||
|
||||
```text
|
||||
例子：
|
||||
https://www.tiktok.com/@hoodvineunrated/video/7039805708220501294?sender_device=pc&sender_web_id=7040621362419451398&is_from_webapp=v1&is_copy_url=0
|
||||
```
|
||||
|
||||
- TikTok/TikTok batch URL (no need to use conformity separation)
|
||||
|
||||
```text
|
||||
例子：
|
||||
1.20 rEu:/ ~猫跟你都想了解 https://v.douyin.com/RCjCE1D/ 复制此链接，打开Dou音搜索，直接观看视频！
|
||||
5.17 dnq:/ 《黑猫警长》吃猫鼠也太强了，不仅把猫当食物，连鳄鱼也害怕它! https://v.douyin.com/RCjVQwh/ 复制此链接，打开Dou音搜索，直接观看视频！
|
||||
8.43 and:/ 一家人不听道士的劝，搬进了鬼别墅，诡异的事情接连发生 %%恐怖 %%热门 %%电影解说 https://v.douyin.com/RCj5pyh/ 复制此链接，打开Dou音搜索，直接观看视频！
|
||||
3.84 FHI:/ 晚上好，蹦迪人，蹦迪魂，蹦迪都是人上人 能蹦几分是几分%%小姐姐蹦迪 %%美不美看大腿 @DOU+小助手 https://v.douyin.com/RCjqkow/ 复制此链接，打开Dou音搜索，直接观看视频！
|
||||
https://www.tiktok.com/@elpanaarabe/video/7038818332270808325?sender_device=pc&sender_web_id=7040621362419451398&is_from_webapp=v1&is_copy_url=0
|
||||
https://www.tiktok.com/@yuuuurinchi/video/7037047426296925442?sender_device=pc&sender_web_id=7040621362419451398&is_from_webapp=v1&is_copy_url=0
|
||||
https://www.tiktok.com/@marlyestevess/video/7039426841836293382?sender_device=pc&sender_web_id=7040621362419451398&is_from_webapp=v1&is_copy_url=0
|
||||
https://www.tiktok.com/@hoodvineunrated/video/7039805708220501294?sender_device=pc&sender_web_id=7040621362419451398&is_from_webapp=v1&is_copy_url=0
|
||||
```
|
||||
|
||||
## 🛰️API usage
|
||||
|
||||
The API can convert the request parameters into the non-watermarked video/picture direct link that needs to be extracted, and it can be downloaded in-app with the IOS shortcut.
|
||||
|
||||
- Parse request parameters
|
||||
|
||||
```text
|
||||
http://localhost(服务器IP):80/api?url="复制的(抖音/TikTok)的(分享文本/链接)"
|
||||
```
|
||||
|
||||
- Return parameter
|
||||
|
||||
> Tik Tok 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="
|
||||
}
|
||||
```
|
||||
|
||||
> Tik Tok 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 video
|
||||
|
||||
```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, but the person is in the United States. Clicking on the result page link reports an error 403. The visual inspection is related to the 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 any name
|
||||
|
||||
- Path select the path of your uploaded file
|
||||
|
||||
- The Python version needs to be at least 3.9 or above (install it yourself in the version management on the left)
|
||||
|
||||
- The frame is modified to`Flask`
|
||||
|
||||
- The startup mode is modified to`python`
|
||||
|
||||
- Start file selection`TikTok_ZH.py`
|
||||
|
||||
- Check to install module dependencies
|
||||
|
||||
- Start up at will
|
||||
|
||||
- If the pagoda is installed`Nginx`Wait for the application to stop or stop it`TikTok_ZH.py`Modify the port at the bottom (the default port is 80)
|
||||
|
||||
|
||||
|
||||
* * *
|
||||
|
||||
## 🎉 Screenshot
|
||||
|
||||
- Main interface
|
||||
|
||||
|
||||
|
||||
* * *
|
||||
|
||||
- Parsing is complete
|
||||
|
||||
> single
|
||||
|
||||
|
||||
|
||||
* * *
|
||||
|
||||
> batch
|
||||
|
||||
|
||||
|
||||
* * *
|
||||
|
||||
- API submission/return
|
||||
|
||||
> Video return value
|
||||
|
||||
|
||||
|
||||
> Atlas return value
|
||||
|
||||
|
||||
|
||||
> TikTok return value
|
||||
|
||||
|
||||
|
||||
* * *
|
||||
Loading…
x
Reference in New Issue
Block a user