抖音数据接口

给 AI agent 用的确定性数据端点：账号、单条视频、近 N 天变化，全部经过字段级校验。不做模型解读，不做幻觉排版。
一个地址、一把令牌、四个模型名。

1. 先拿令牌

  1. 用邀请码在 bot.looom.top/me/register 注册（邀请码向我索取）
  2. 登录 api.looom.top → 控制台 → 令牌 → 创建一把 key
  3. 这把 key 填进你的 agent 配置即可（它就是通行证）

令牌只创建时显示一次，请保存。填给你 agent 时，它等价于你的账号权限。

2. 四个模型名

模型干什么输入调用上游计费
douyin-data账号维度取新数据分享链接 / 抖音号 / sec_uid是按次
douyin-video单条视频：播放量 / 互动 / 评论区 / 下载地址 v1.1视频分享链接 或 作品ID是按次
douyin-trend近 N 天：新增 + 环比 v1.1链接 / 抖音号 / sec_uid（可带「近 30 天」）是按次
douyin-read只读已托管的历史数据目标 或 16 位记录号否免费
为什么要这么分：要调上游（花钱）的按次计费；读你自己已经拿到的数据不该再收一次钱，所以 douyin-read 免费。同一份台账，两种价格。

3. 调用方式（OpenAI 兼容）

# ① 账号维度（收费）
curl https://api.looom.top/v1/chat/completions \
  -H "Authorization: Bearer <令牌>" -H "Content-Type: application/json" \
  -d '{"model":"douyin-data","messages":[{"role":"user","content":"https://v.douyin.com/xxxx/ 前10条作品"}]}'

# ② 单条视频（收费）——给分享链接或作品ID；「评论 30 条」控条数（默认20，上限50），「不要评论」跳过
  -d '{"model":"douyin-video","messages":[{"role":"user","content":"https://v.douyin.com/xxxx/ 评论 30 条"}]}'

# ③ 近 N 天 + 环比（收费）——默认 7 天，可写「近 30 天」
  -d '{"model":"douyin-trend","messages":[{"role":"user","content":"bendanshuolishi 近 30 天"}]}'

# ④ 回看托管数据（免费）
  -d '{"model":"douyin-read","messages":[{"role":"user","content":"记录 3f0731d677834c9c"}]}'

目标抽取是正则确定性解析（分享链接 / sec_uid / 抖音号 / 17–20 位作品ID），不经过模型。返回是标准 OpenAI 响应，content = 人可读摘要 + 完整 JSON 代码块。

4. 返回什么

// douyin-data
{"account":{"昵称":"…","粉丝数":492207,"获赞数":7523436,"作品数":1909,"IP属地":"广东"},
 "videos":[{"aweme_id":"…","发布时间":"2026-09-05","点赞数":13677,"评论数":107,"分享数":583}],
 "record_id":"3f0731d677834c9c"}

// douyin-video
{"video":{"aweme_id":"…","标题":"…","发布时间":"2026-09-05","时长秒":158,
          "播放量":142838,"点赞数":13670,"评论数":124,"分享数":583,"收藏数":1631,
          "播放地址":"https://…","下载地址":"https://…","是否有水印":true},
 "author":{"昵称":"…","抖音号":"…","粉丝数":null},
 "comments":[{"文本":"…","点赞数":0,"时间":"2026-09-06","IP属地":"北京","回复数":1,"是否热评":true,"作者昵称":"…"}],
 "record_id":"…"}

// douyin-trend
{"trend":{"窗口天数":7,
          "当前":{"粉丝数":491525,"获赞数":7530373,"作品数":15},
          "新增":{"新增粉丝":-981,"新增点赞":13703,"新增评论":189,"新增分享":1672,"新增作品":1},
          "环比":{"新增点赞环比":-39.9,"新增分享环比":154.1,…},
          "日均":{"日均点赞":1957.6,…}},
 "record_id":"…"}

5. 字段词典（确定性口径）

字段含义
粉丝数 / 获赞数 / 作品数账号总量。粉丝数 ≠ 点赞数
点赞数 / 评论数 / 分享数 / 收藏数单条作品的互动数
播放量单条作品播放数；null = 上游未提供（不会用 0 冒充）
播放地址 / 下载地址抖音 CDN 链接，会过期——只保证当次可用
新增粉丝窗口内净增，可为负（净掉粉）
*环比单位 %，相对上一个同长度窗口的变化率；-39.9 = 减少 39.9%
record_id本次交付在台账里的编号，凭它可免费回看

不提供：私密数据。视频文件本身不下发，只给当次可用的 CDN 地址。

6. 错误与异常

情况表现
令牌无效 / 额度不足 / 订阅到期HTTP 401/403（由网关判定）
消息里找不到可识别目标HTTP 200，content 说明缺什么 → agent 可自我纠正
目标不存在 / 指数未覆盖HTTP 404 + error.message
上游取数失败HTTP 502 + error.message（可重试）

7. 托管台账（交付 = 存储）

每次成功交付都会写入只增不改的台账：返回给你的，和你回看时读到的，是同一份字节。四个模型共用同一张台账。
你也可以在 bot.looom.top/me 用同一套账号登录，看到自己的全部托管记录——和你 agent 通过 douyin-read 拿到的是同一份。

8. 给 agent 的一句话

读 /agent-card.json 拿能力清单 → 用 Bearer 令牌 → 账号用 douyin-data、单条视频用 douyin-video、趋势用 douyin-trend、回看用 douyin-read。

数据来源：抖音公开页面与抖音指数 · 本服务只做字段级确定性映射，不做内容解读 · 台账与本页同源