快速开始
抖音评论导出 API
5 分钟快速开始
不需要先读完整文档。创建一枚 API Key,复制下面的请求, 再用任务 ID 获取结果即可。
一个公开抖音视频链接 足够的可用积分 服务端或本地命令行
环境变量
EXPORTDOU_API_KEY=ed_live_...请求头
Authorization: Bearer $EXPORTDOU_API_KEYAPI Key 只能放在服务端环境变量或本机凭证中,不要写进网页代码、Git 仓库或公开日志。
02
提交导出任务
替换抖音链接后运行。接口会立即返回任务 ID,抓取在后台继续。
复制后直接运行
curl https://api.exportdou.cn/v1/exports \
-X POST \
-H "Authorization: Bearer $EXPORTDOU_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"input": "https://www.douyin.com/video/...",
"resultLimit": 1000,
"includeReplies": true,
"format": "csv"
}'201 响应
{
"id": "4bf3d2d8-...",
"status": "queued",
"reservedCredits": 1000,
"dispatchDelayed": false
}保存 id。下一步查询进度时需要它。
- resultLimit
- 最多导出的总行数
- includeReplies
- 是否同时抓取评论回复
- format
- csv 或 xlsx
- Idempotency-Key
- 重试时复用,防止重复创建
Node.js 18+ 创建任务
import { randomUUID } from 'node:crypto';
const apiKey = process.env.EXPORTDOU_API_KEY;
if (!apiKey) throw new Error('缺少 EXPORTDOU_API_KEY');
const response = await fetch('https://api.exportdou.cn/v1/exports', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': randomUUID(),
},
body: JSON.stringify({
input: 'https://www.douyin.com/video/...',
resultLimit: 1000,
includeReplies: true,
format: 'csv',
}),
});
if (!response.ok) {
throw new Error(response.status + ' ' + await response.text());
}
console.log(await response.json()); Python 3 + requests 创建任务
import os
import uuid
import requests
response = requests.post(
"https://api.exportdou.cn/v1/exports",
headers={
"Authorization": "Bearer " + os.environ["EXPORTDOU_API_KEY"],
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"input": "https://www.douyin.com/video/...",
"resultLimit": 1000,
"includeReplies": True,
"format": "csv",
},
timeout=30,
)
response.raise_for_status()
print(response.json())两个示例与上面的 cURL 请求使用同一组字段。Python 示例需要先安装 requests; 服务端重试创建请求时必须复用同一个 Idempotency-Key,不能每次生成新值。
03
查询进度并下载
按照响应中的 retryAfterSeconds 查询;完成后下载完整文件。
查询任务
curl https://api.exportdou.cn/v1/exports/<task-id> \
-H "Authorization: Bearer $EXPORTDOU_API_KEY" 下载结果
curl -L https://api.exportdou.cn/v1/exports/<task-id>/download \
-H "Authorization: Bearer $EXPORTDOU_API_KEY" \
-o comments.csv 继续等待
queued · processing · rendering 导出完成
completed 下载或继续
partial 停止查询
failed · cancelled跑通了
打开 API 参考 字段说明、错误码、预览接口和取消任务都在 API 参考中。
04
抖音官方评论接口和抖评岛 API 有什么区别?
两者解决的任务不同。选择前先确认授权方式、输入形式和最终结果。
| 比较项 | 抖音开放平台评论接口 | 抖评岛导出 API |
|---|---|---|
| 开始条件 | 按官方文档申请对应评论权限,并完成所需的用户授权 | 在抖评岛账户中创建 API Key,并确保积分与套餐权限充足 |
| 提交内容 | 按官方接口要求传入授权业务对应的资源标识 | 传入可公开访问的抖音视频链接或包含链接的分享文案 |
| 结果形态 | 评论列表、回复管理等官方接口响应 | 持久化导出任务,可查询进度并下载 CSV 或 Excel |
| 服务关系 | 抖音开放平台官方能力 | 第三方导出服务,与抖音官方无隶属或合作关系 |
官方接入要求以 抖音视频评论管理方案和 评论列表接口文档为准;抖评岛接口的字段、状态和错误码以本站 API 参考为准。
不想手写 HTTP?
直接使用 Agent 或 CLI
和 API 共用同一账户、积分与任务记录。CLI 登录会打开浏览器授权,不需要手动复制 Key。
npx skills add wegoft/exportdou-agent-tools --skill exportdounpx exportdou login
npx exportdou export "<抖音链接>" --limit 1000
npx exportdou status "<task-id>" --json
npx exportdou resume "<partial-task-id>" --json