内容采集 API

快速开始

登录用户中心，在“API 与开发者”中创建密钥。完整密钥只显示一次，请立即复制保存。

curl -X POST https://www.yuntuagi.cn/v1/media/douyin-video-info \
  -H "Authorization: Bearer ytk_your_key" \
  -H "Idempotency-Key: request-20260905-001" \
  -H "Content-Type: application/json" \
  -d '{"aweme_id":"7592116912205630761"}'

身份验证

把密钥放在 Authorization: Bearer ... 请求头中。不要通过网址参数传递密钥，也不要把密钥提交到公开仓库。每次业务请求都要生成一个新的 Idempotency-Key，不要把同一个标识用于不同请求。

返回字段

接口不会直接返回采集源的原始数据。网站会先清洗并统一字段，只保留运营分析实际需要的作者、作品、媒体地址、互动数据、标签和分页信息。

data: {
  schema_version, platform, kind,
  profile: { name, id, home_url, avatar_url, signature, metrics, attributes },
  works: [{ id, title, caption, source_url, author, published_at,
    duration_seconds, media, metrics, tags, platform }],
  pagination: { cursor, next_cursor, has_more, total }
}

限流与积分额度

同一账号下所有密钥合计每 20 秒可发起一次请求。每个密钥可以单独设置每日积分上限，按北京时间每天 00:00 重新计算。只有成功请求才扣积分。

错误处理

402 表示积分不足；429 表示调用过快或当天额度已用完；409 表示重复请求标识与原请求不一致。遇到 429 时请按 Retry-After 等待。

接口与价格

当前开放的接口和实时价格，以用户中心“API 与开发者”页面以及可下载的 OpenAPI JSON 为准。