TikTokDownloader 批量导出 TikTok 作品链接指南:一条主页链接换整份清单
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
TikTokDownloader 是 TikTok 作品下载/数据采集工具。丢进一条创作者主页链接,5 分钟内批量获取该账号全部公开作品的标准链接(https://www.tiktok.com/video/<id>格式),产出一份纯文本清单,可直接喂给下载器或导入 CSV。
预览:清单长什么样
https://www.tiktok.com/@target_creator/video/7301234567890123456 https://www.tiktok.com/@target_creator/video/7306543210987654321 https://www.tiktok.com/@target_creator/video/7309876543210987654每一行都是标准作品链接,发布几百条视频的账号就出几百行。清单可批量下载、登记进 CSV、丢进分析脚本。
第一幕 备料:装环境、取身份、备登录态
装好能跑的环境
执行三步:
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader pip install -r requirements.txt要求 Python 3.8+,推荐 3.10+。跑python main.py能进终端交互模式,即环境就绪。
从主页链接取出 sec_user_id
sec_user_id是账号在 API 层的唯一标识,比 @username 稳定,整条批量链路靠它。两种取法:
代码取法:用 ExtractorTikTok,正则匹配主页 URL,请求页面 HTML 抠出secUid字段:
from asyncio import run from src.config import Parameter from src.link.extractor import ExtractorTikTok extractor = ExtractorTikTok(Parameter()) ids = run(extractor.user("https://www.tiktok.com/@username")) print(ids)交互取法:python main.py启动,选"批量下载账号作品(TikTok)",按提示粘贴主页链接,程序自动解析并填入sec_user_id。
备好登录态 Cookie
采私密账号时必填,且登录账号需已关注目标。从浏览器提取 Cookie 写进配置文件,参考 docs/screenshot/Cookie获取教程1.png 的取法界面。
第二幕 取数:先定路线,再动手拉
会 Python、要二次加工数据 → 通道 A:脚本 不写代码 / 定时跑 / 远程调用 → 通道 B:WebAPI 两条路拿到的数据完全一致通道 A:脚本调用 AccountTikTok
核心是 AccountTikTok。它封装 TikTok 的api/post/item_list/接口,按sec_user_id+cursor自动翻页,拉完或触发时间截断即停:
from asyncio import run from src.config import Parameter from src.interface.account_tiktok import AccountTikTok account = AccountTikTok( Parameter(), sec_user_id="MS4wLjABAAAA...", tab="post", # 喜欢页用 favorite count=30, ) response, earliest, latest = run(account.run(single_page=False)) urls = [f"https://www.tiktok.com/video/{i['id']}" for i in response]要点:
run(single_page=False)返回"作品列表、最早发布时间、最晚发布时间"三元组tab="favorite"切喜欢页,该模式下pages才真正限制翻页次数- 标题、点赞、时长直接读
item字典字段,链接只是其中一小部分
通道 B:WebAPI 调 /tiktok/account
启动 WebAPI 模式,Swagger 文档在http://127.0.0.1:5555/docs。账号作品采集端点为POST /tiktok/account:
POST /tiktok/account Content-Type: application/json token: <配置文件中的token> { "sec_user_id": "MS4wLjABAAAA...", "tab": "post", "count": 30 }请求体字段与通道 A 一一对应。返回数据自带id字段,拼成https://www.tiktok.com/video/{id}即标准链接。
第三幕 让数据好用:拼链接、导出、增量
拼标准链接
取返回字典里的item["id"],拼https://www.tiktok.com/video/{id}。逐行写入文本文件,就得到开头的清单。
导出 CSV / XLSX
程序内置 CSV/XLSX 保存能力,执行完在界面把结果导出成文件,运营拿到清单直接归档。
做增量采集
把上一轮的earliest存到本地文件,下轮请求带回。只拉新作品,不重复翻页。
参数速查表
| 参数 | 含义 | 推荐值 |
|---|---|---|
count | 每页请求作品数 | 20–30,太大易触发风控 |
cursor | 分页游标 | 填 0,翻页自动递增 |
pages | 最大请求页数 | 按总量估,20 页 × 30 条 ≈ 600 条 |
tab | 作品页类型 | post发布 /favorite喜欢 |
earliest | 最早发布时间;程序从新到旧翻页,遇到早于它的条目即停,请求量骤减,提速最有效 | 2024/01/01格式,或距今天数 |
latest | 最晚发布时间 | 默认当天,一般不动 |
proxy | 代理地址 | 地区受限出口填http://ip:port |
cookie | 登录态 | 私密账号必填,且需已关注目标 |
排障速查:一行修一个
| 现象 | 原因 | 一行修复 |
|---|---|---|
| 提示"该账号为私密账号" | 私密目标未带登录态 | 请求附cookie,该账号先关注目标 |
sec_user_id无效 / 空列表 | 主页 URL 打错或账号注销 | 重开主页复制 URL,跑一遍提取器 |
| 生成的链接打不开 | 本地 IP 被地区限制 | 加proxy换出口再试 |
| 中途停,日志显示 Cookie 未登录 | Cookie 过期 | 浏览器重新提取,更新配置 |
| 翻几页后数据不增长 | 请求过频被限流 | 调小count,拉开任务间隔 |
合规红线
⚠️ 先做四条,再跑批量:
- 遵守 TikTok 服务条款与 robots 协议,仅采集公开可访问内容
- 同一账号连续请求间隔 > 5 秒,批量任务之间留缓冲
- 数据仅用于备份、研究等正当用途;商用先联系创作者取得授权
- 本仓库为只读参考,一切产物输出到自己本地目录
一条主页链接,5 分钟换整份公开作品清单;清单接着可交给 src/downloader/download.py 做批量下载。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考