快速开始

抖音评论导出 API
5 分钟快速开始

不需要先读完整文档。创建一枚 API Key,复制下面的请求, 再用任务 ID 获取结果即可。

一个公开抖音视频链接 足够的可用积分 服务端或本地命令行
01

创建 API Key

Key 明文只展示一次,创建后持续有效,直到你主动撤销。

前往创建
环境变量EXPORTDOU_API_KEY=ed_live_...
请求头Authorization: Bearer $EXPORTDOU_API_KEY

API 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。

Agent SkillCodex、Claude Code、Cursor、OpenClaw
npx skills add wegoft/exportdou-agent-tools --skill exportdou
抖评岛 CLI登录后直接提交链接
npx exportdou login npx exportdou export "<抖音链接>" --limit 1000 npx exportdou status "<task-id>" --json npx exportdou resume "<partial-task-id>" --json
查看 CLI 与 Skill 源码