TikTokDownload开发者API文档：接口调用全指南
项目地址: https://gitcode.com/gh_mirrors/ti/TikTokDownload 1. 引言
1.1 文档概述
本文档详细介绍了TikTokDownload项目的API接口，包括接口功能、请求参数、响应格式、错误码及使用示例等内容。通过本文档，开发者可以快速了解和使用TikTokDownload的API接口，实现抖音用户信息获取、作品下载等功能。
1.2 适用对象
本文档主要面向TikTokDownload项目的开发者和集成者，要求读者具备一定的HTTP协议、JSON数据格式和Python编程语言基础。
1.3 接口版本
本文档描述的API接口版本为v1.0。
2. 接口概览
TikTokDownload提供了以下几类API接口：
| 接口类别 | 接口名称 | 功能描述 |
|---|---|---|
| 用户信息接口 | 获取用户基本信息 | 获取抖音用户的基本信息，如用户ID、昵称、头像等 |
| 作品接口 | 获取用户作品详情 | 获取抖音用户单个作品的详细信息，如作品ID、描述、播放量等 |
| 作品接口 | 获取用户图片作品信息 | 获取抖音用户图片类作品的信息，如图片URL、描述等 |
| 作品接口 | 获取用户视频作品信息 | 获取抖音用户视频类作品的信息，如视频URL、时长等 |
| 作品接口 | 删除用户作品 | 删除抖音用户的指定作品 |
| 用户信息接口 | 获取用户个人资料信息 | 获取抖音用户的个人资料信息，如签名、关注数、粉丝数等 |
3. 接口详情
3.1 获取用户基本信息
3.1.1 接口功能
获取抖音用户的基本信息，包括用户ID、昵称、头像等。
3.1.2 请求参数
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| sec_uid | string | 是 | 用户的sec_uid |
3.1.3 响应格式
{
"status_code": 0,
"next_req_count": 0,
"data": [
{
"uid": "89964046416",
"short_id": "629064951",
"nickname": "蔓越莓烦恼",
"avatar_thumb": {
"uri": "100x100/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef",
"url_list": [
"https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef.jpeg?from=3782654143",
"https://p6.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef.jpeg?from=3782654143",
"https://p11.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef.jpeg?from=3782654143"
]
},
"signature": "风格多变的小🦁️\n🧣：yoki小蔓\n🍠：同名",
"follow_status": 1,
"enterprise_verify_reason": "",
"verification_type": 0,
"custom_verify": "",
"unique_id": "777_23",
"commerce_user_level": 0,
"with_commerce_entry": false,
"is_block": false,
"sec_uid": "MS4wLjABAAAADgOltsr_SYTX6VurKA1H3n61xlFvYD1y_FrrY1UhI-o",
"webcast_sp_info": {},
"has_e_account_role": false,
"follower_status": 0,
"avatar_small": {
"uri": "168x168/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef",
"url_list": [
"https://p6.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef~c5_168x168.webp?from=3782654143",
"https://p26.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef~c5_168x168.webp?from=3782654143",
"https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef~c5_168x168.webp?from=3782654143",
"https://p6.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_9c8aea4ba21f591774723a3820a07aef~c5_168x168.jpeg?from=3782654143"
]
},
"gender": 2
}
],
"extra": {
"fatal_item_ids": [],
"logid": "20230720194718A0B55C720A4E710A68EF",
"now": 1689853638000
},
"log_pb": {
"impr_id": "20230720194718A0B55C720A4E710A68EF"
}
}
3.1.4 响应参数说明
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status_code | integer | 状态码，0表示成功 |
| data | array | 用户基本信息数组 |
| data[0].uid | string | 用户ID |
| data[0].short_id | string | 用户短ID |
| data[0].nickname | string | 用户昵称 |
| data[0].avatar_thumb | object | 用户头像缩略图信息 |
| data[0].avatar_thumb.url_list | array | 用户头像缩略图URL列表 |
| data[0].signature | string | 用户签名 |
| data[0].sec_uid | string | 用户sec_uid |
3.1.5 使用示例
import requests
url = "https://api.tiktokdownload.com/user/base_info"
params = {
"sec_uid": "MS4wLjABAAAADgOltsr_SYTX6VurKA1H3n61xlFvYD1y_FrrY1UhI-o"
}
response = requests.get(url, params=params)
print(response.json())
3.2 获取用户作品详情
3.2.1 接口功能
获取抖音用户单个作品的详细信息，包括作品ID、描述、播放量等。
3.2.2 请求参数
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| aweme_id | string | 是 | 作品ID |
3.2.3 响应格式
{
"aweme_detail": {
"activity_video_type": 0,
"admire_auth": {
"admire_button": 0,
"author_can_admire": 0,
"exit_admire_in_aweme_post": 0,
"is_admire": 0,
"is_click_admire_icon_recently": 0,
"is_fifty_admire_author_stable_fans": 0,
"is_iron_fans_in_aweme_post": 0,
"is_show_admire_button": 0,
"is_show_admire_tab": 0
},
"anchors": null,
"authentication_token": "MS4wLjAAAAAANyRrG5Pc-vuXA0GLydogCwzhiFLi6WTBtXip2GW2PU-iKfl3cohIbiKnusp5yQA33rgzXsD6iJmm7td2cYSH_Ys8s-17ENHTgs_Yyi-ZoFFJPJB-69Nc0G52o0RNJ5eFsUO4I5Qu_eD-blXDU95cE1pPL1j_-KJYSLborn6E5BcIWa0f0KJW-uBmnHBE-pim",
"author": {
"avatar_thumb": {
"height": 720,
"uri": "100x100/aweme-avatar/tos-cn-avt-0015_b4a51067e5d3c41d5d7758f14532ace6",
"url_list": [
"https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_b4a51067e5d3c41d5d7758f14532ace6.webp?from=116350172",
"https://p11.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_b4a51067e5d3c41d5d7758f14532ace6.webp?from=116350172",
"https://p6.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_b4a51067e5d3c41d5d7758f14532ace6.webp?from=116350172",
"https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_b4a51067e5d3c41d5d7758f14532ace6.jpeg?from=116350172"
],
"width": 720
},
"nickname": "百里TUFU",
"sec_uid": "MS4wLjABAAAAERbHksh_jtLRYjO8hOx9clHF9tJDBsZmhcL0VoPLItYXWg8H0jwYJd3mJOxiIGsU",
"unique_id": "bailitufu8"
},
"aweme_id": "7071967230287744267",
"desc": "其实早就和你表白过了 在看你的每个眼神里",
"statistics": {
"admire_count": 0,
"collect_count": 3799,
"comment_count": 7343,
"digg_count": 165539,
"play_count": 0,
"share_count": 23537
},
"video": {
"bit_rate": [
{
"FPS": 30,
"bit_rate": 498449,
"play_addr": {
"url_list": [
"https://v5-coldi.douyinvod.com/fb233b897397b568a466a9aebe834d76/64ba6dea/video/tos/cn/tos-cn-ve-15-alinc2/765ec3b0e54f4da7ab73889be9103fee/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=486&bt=486&cs=2&ds=3&ft=bvjWJkQQqUWXf_40mo0OW_EklpPiXYhEiMVJEAmEA.CPD-I&mime_type=video_mp4&qs=15&rc=OTY0M2U6Nmg8OzM2NThmOUBpMzdkODk6ZmhkOzMzNGkzM0A0MzYvXzE2NTQxLzY2NDQ0YSNucWIwcjRvbGZgLS1kLTBzcw%3D%3D&l=20230721183704115C8631EBB6BF156092&btag=e00088000&dy_q=1689935825",
"https://v3-cold3.douyinvod.com/7252d5e0367080dd07125dd3390a1f92/64ba6dea/video/tos/cn/tos-cn-ve-15-alinc2/765ec3b0e54f4da7ab73889be9103fee/?a=1128&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=486&bt=486&cs=2&ds=3&ft=bvjWJkQQqUWXf_40mo0OW_EklpPiXYhEiMVJEAmEA.CPD-I&mime_type=video_mp4&qs=15&rc=OTY0M2U6Nmg8OzM2NThmOUBpMzdkODk6ZmhkOzMzNGkzM0A0MzYvXzE2NTQxLzY2NDQ0YSNucWIwcjRvbGZgLS1kLTBzcw%3D%3D&l=20230721183704115C8631EBB6BF156092&btag=e00088000&dy_q=1689935825"
]
}
}
]
}
}
}
3.2.4 响应参数说明
| 参数名称 | 类型 | 描述 |
|---|---|---|
| aweme_detail.aweme_id | string | 作品ID |
| aweme_detail.desc | string | 作品描述 |
| aweme_detail.statistics | object | 作品统计信息 |
| aweme_detail.statistics.digg_count | integer | 点赞数 |
| aweme_detail.statistics.comment_count | integer | 评论数 |
| aweme_detail.statistics.share_count | integer | 分享数 |
| aweme_detail.statistics.collect_count | integer | 收藏数 |
| aweme_detail.video.bit_rate | array | 视频码率信息数组 |
| aweme_detail.video.bit_rate[0].play_addr.url_list | array | 视频播放地址列表 |
3.2.5 使用示例
import requests
url = "https://api.tiktokdownload.com/aweme/detail"
params = {
"aweme_id": "7071967230287744267"
}
response = requests.get(url, params=params)
print(response.json())
3.3 获取用户图片作品信息
3.3.1 接口功能
获取抖音用户图片类作品的信息，包括图片URL、描述等。
3.3.2 请求参数
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| sec_uid | string | 是 | 用户的sec_uid |
| max_cursor | integer | 否 | 分页游标，默认为0 |
3.3.3 响应格式
{
"status_code": 0,
"min_cursor": 1689909551000,
"max_cursor": 1689909551000,
"has_more": 1,
"aweme_list": [
{
"aweme_id": "7232626237586312485",
"desc": "辣妹统治世界٩(˃̶͈̀௰˂̶͈́)و。#ootd穿搭 #氛围感 #女友穿搭#辣妹穿搭 #生活碎片",
"create_time": 1683977029,
"author": {
"uid": "64115698134",
"nickname": "肥牛卷儿（我爱吴世勋",
"avatar_thumb": {
"uri": "100x100/aweme-avatar/tos-cn-avt-0015_0f0f760731f3a659ad557fb9718a7019",
"url_list": [
"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_0f0f760731f3a659ad557fb9718a7019.jpeg?from=116350172"
]
},
"sec_uid": "MS4wLjABAAAA-hFsLR8fSnbmWhrmAEnGvYgG6rM2txNpNm2oT9WSrIQ"
},
"statistics": {
"admire_count": 1,
"comment_count": 166,
"digg_count": 20629,
"collect_count": 1572,
"play_count": 0,
"share_count": 406
},
"share_url": "https://www.iesdouyin.com/share/video/7232626237586312485/?region=CN&mid=7203284398119225346&u_code=l1j9bkbd&did=MS4wLjABAAAAtqpCx0hpOERbdSzQdjRZw-wFPxaqdbAzsKDmbJMUI3KWlMGQHC-n6dXAqa-dM2EP&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&titleType=title&schema_type=37&share_sign=wjgkFzHXh6p.xcQ.fS.Ficm9.QSyu256DJAsxMt1IGI-&share_version=170400&ts=1690995606&from_ssr=1"
}
]
}
3.3.4 响应参数说明
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status_code | integer | 状态码，0表示成功 |
| has_more | integer | 是否有更多数据，1表示有，0表示无 |
| aweme_list | array | 作品列表 |
| aweme_list[0].aweme_id | string | 作品ID |
| aweme_list[0].desc | string | 作品描述 |
| aweme_list[0].create_time | integer | 作品创建时间戳 |
| aweme_list[0].statistics | object | 作品统计信息 |
| aweme_list[0].share_url | string | 作品分享链接 |
3.3.5 使用示例
import requests
url = "https://api.tiktokdownload.com/user/post/info/image"
params = {
"sec_uid": "MS4wLjABAAAA-hFsLR8fSnbmWhrmAEnGvYgG6rM2txNpNm2oT9WSrIQ",
"max_cursor": 0
}
response = requests.get(url, params=params)
print(response.json())
4. 错误码说明
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| 0 | 请求成功 | - |
| 1001 | 参数错误 | 检查请求参数是否正确 |
| 1002 | 用户不存在 | 确认sec_uid是否正确 |
| 1003 | 作品不存在 | 确认aweme_id是否正确 |
| 1004 | 接口限流 | 稍后再试或降低请求频率 |
| 1005 | 服务器内部错误 | 联系技术支持 |
5. 接口调用流程
st=>start: 开始
op1=>operation: 获取用户sec_uid
op2=>operation: 调用用户信息接口
op3=>operation: 获取作品ID列表
op4=>operation: 调用作品详情接口
op5=>operation: 解析响应数据
e=>end: 结束
st->op1->op2->op3->op4->op5->e
6. 注意事项
- 接口调用需要遵守抖音的相关规定和限制，不得进行恶意请求或滥用接口。
- 接口返回的URL可能具有时效性，建议及时使用或缓存。
- 部分接口需要用户登录态或特殊权限，具体请参考接口文档说明。
- 如遇到接口调用问题，请先检查请求参数和网络连接，如仍有问题可联系技术支持。
7. 总结
本文档详细介绍了TikTokDownload项目的API接口，包括接口功能、请求参数、响应格式、错误码及使用示例等内容。开发者可以根据本文档快速集成TikTokDownload的API接口，实现抖音用户信息获取、作品下载等功能。如有任何疑问或建议，请联系项目开发团队。
8. 资源与互动
如果您觉得本文档对您有帮助，请点赞、收藏并关注我们，以便获取更多关于TikTokDownload的开发资源和更新信息。下期预告：TikTokDownload高级功能详解，敬请期待！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
