API v1

基础地址为 https://exportdou.cn/api/v1。所有业务接口使用 Bearer API Key，并返回 JSON。

1. 创建 API Key

登录后前往 API Key 与 Agent 创建凭证。 Key 只展示一次，并且可以按设备单独撤销。推荐 CLI 用户直接运行 npx exportdou login，无需手动复制。

2. 提交导出

curl https://exportdou.cn/api/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/1234567890",
    "resultLimit": 1000,
    "includeReplies": true,
    "format": "csv"
  }'

resultLimit 是一级评论与回复合计上限，范围 1–200,000。 创建时先冻结相同数量的积分，完成后只按实际导出行数结算，未使用部分自动释放。

3. 查询和下载

curl -H "Authorization: Bearer $EXPORTDOU_API_KEY" \
  https://exportdou.cn/api/v1/exports/<task-id>

curl -L -H "Authorization: Bearer $EXPORTDOU_API_KEY" \
  -o comments.csv \
  https://exportdou.cn/api/v1/exports/<task-id>/download

任务状态为 queued、processing 或 rendering 时，读取响应中的 retryAfterSeconds 再查询。不要重新提交原链接来检查进度。

核心接口

方法路径用途
GET/account验证凭证与读取账户
GET/credits读取可用和冻结积分
POST/videos/preview解析链接并读取视频与评论样本
POST/exports创建幂等导出任务
GET/exports/:id读取进度与结果元数据
GET/exports/:id/preview读取最多 50 条 JSON 结果预览
GET/exports/:id/download下载完整私有结果文件
POST/exports/:id/cancel请求取消任务

错误与重试

4xx 表示请求、权限或余额问题，不应盲目重试；429 和 5xx 可以按响应建议退避。 对创建请求重试时必须复用同一个 Idempotency-Key，这样不会重复冻结积分或创建任务。

完整字段、状态枚举与示例请下载 OpenAPI 3.1 文档。