310 个抖音数据接口正式上线 SandBase
SandBase 生态现已接入 310 个抖音数据接口，覆盖搜索、创作者分析、视频数据、热榜、星图达人等，全部通过 /v1/run 调用。
先说结论 — 310 个抖音数据接口已接入 SandBase agent 生态。十个功能频道：指数类（72 个）、网页数据（45）、App 级数据（40）、排行榜（32）、星图达人市场（58 合计）、创作者分析（37）、DOU+ 推广（16）、搜索（10）。79% 的接口 $0.001/次。你的 agent 调它和调 LLM 一样——一个契约、一把钥匙、同步返回。
接入了什么
310 个抖音结构化 API 操作，分为 10 个频道：
| 频道 | 接口数 | 覆盖内容 | 价格区间 |
|---|---|---|---|
douyin/index/* | 72 | 热门指数、核心指标、数据看板 | $0.001-$0.02 |
douyin/web/* | 45 | 公开网页数据、知识视频、直播间 | $0.001-$0.01 |
douyin/app-v3/* | 40 | App 级视频数据、用户资料、批量查询 | $0.001-$0.25 |
douyin/billboard/* | 32 | 热门账号榜、趋势内容排名 | $0.001 |
douyin/xingtu-v2/* | 30 | 星图达人市场 v2（筛选字段、排名、分析） | $0.001-$0.02 |
douyin/xingtu/* | 28 | 星图达人市场 v1（KOL 指数、活动数据） | $0.001-$0.02 |
douyin/creator/* | 23 | 创作者内容分类、受众数据、表现指标 | $0.001 |
douyin/douplus/* | 16 | DOU+ 推广数据、可投放作品、投放分析 | $0.001 |
douyin/creator-v2/* | 14 | 创作者数据 v2、作品列表、导出 | $0.001-$0.01 |
douyin/search/* | 10 | 视频搜索、话题搜索、用户搜索 | $0.001-$0.01 |
价格分布
79% 的操作（310 个里的 246 个）每次调用 $0.001：
| 价格 | 接口数 | 占比 |
|---|---|---|
| $0.001 | 246 | 79.4% |
| $0.02 | 23 | 7.4% |
| $0.01 | 12 | 3.9% |
| $0.002-$0.005 | 16 | 5.2% |
| $0.05-$0.25 | 9 | 2.9% |
| 免费 | 1 | 0.3% |
$0.25 档覆盖的是批量视频获取（完整元数据）。日常查询（用户资料、单视频、热榜）全在 $0.001 档。
怎么调
所有抖音接口都通过你已经在用的 /v1/run 端点调用：
curl -X POST https://api.sandbase.ai/v1/run \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "douyin/search/challenge-search-v1",
"keyword": "AI创作",
"count": 20
}'同步返回 JSON——和调 LLM 或其他 SandBase 能力一模一样。不需要额外鉴权、不需要装 SDK、不需要配 webhook。
契约归一化
底层这 310 个操作有不同的 HTTP 方法（GET vs POST）、不同的参数位置（query string vs body vs path）、不同的 body 结构（对象、数组、可选字符串）。SandBase 的 adapter 层处理这些差异。
你的 agent 看到的：
- 一个端点：
/v1/run - 一套鉴权：你的 API Key
- 一个请求格式：
{"model": "<operation-name>", ...参数} - 一个响应格式：JSON 对象，每次一样
Adapter 处理的：
- GET 操作的 query 参数 → 从你的 JSON body 映射
- POST 操作的嵌套 JSON → 类型保留透传
- Path 参数 → 安全提取注入
- 必填/可选字段校验 → 到达上游前 fail-closed
能用来做什么
竞品情报（每天，$0.90/月）
跟踪 10 个竞品账号：
每天早上：
1. douyin/app-v3/user-profile × 10 → 粉丝变化
2. douyin/creator/item-list × 10 → 检测新视频
3. douyin/app-v3/video-detail × N → 新视频互动数据
4. LLM 分析 → 生成简报费用：约 30 次/天 × $0.001 = $0.03/天 = $0.90/月。
内容趋势检测（每小时，$14.40/月）
监控你所在垂直领域的热点：
每 15 分钟：
1. douyin/billboard/hot-account-list → 谁在涨
2. douyin/index/topic-query × 3 → 话题热度变化
3. douyin/search/challenge-search-v1 → 标签活跃度
4. LLM 分类 → 相关则告警费用：约 5 次/轮 × 96 轮/天 × $0.001 = $0.48/天 = $14.40/月。
KOL 评估（按需，$0.02-$0.06/人）
投放前给达人打分：
每个 KOL：
1. douyin/app-v3/user-profile → 粉丝数、简介
2. douyin/xingtu-v2/kol-xingtu-index → 平台评分
3. douyin/creator/creator-content-category → 内容分类
4. douyin/index/daren-great-item-mile-info → 核心表现指标
5. douyin/creator/item-list → 最近 20 条视频算互动率费用：5-6 次调用 × $0.001-$0.02 = 每个 KOL $0.02-$0.06。评估 100 个 KOL 花 $2-$6。
SandBase 在原始端点之上加了什么
这 310 个接口生活在 SandBase 生态里，意味着它们和其他集成能力共享 runtime 级别的编排：
- Session 上下文：抖音数据调用和 LLM 调用、sandbox 执行、其他工具在同一个 agent session 里。Agent 拿到数据的同一个 turn 就能推理。
- 可组合：搜索 → 按互动过滤 → 拉详情 → LLM 打分 → 输出报告，一个 workflow 定义搞定。
- 可观测：每次抖音 API 调用出现在你的 trace 里，带延迟、费用、用了什么参数。调试 agent 为什么做了某个决策。
- Skill 封装：把”每日竞品简报”包装成可复用 skill，其他 agent 直接调用不用重新集成抖音。
- 路由感知：如果某个上游端点变慢或降级，系统观测并报告——你的 agent 拿到清晰的错误信号，不是静默挂起。
局限
直说不能做什么：
- 不能发帖或管理账号 — 这是只读数据访问，不是内容管理 API 集成
- 上游响应时间无 SLA 保证 — 典型延迟 1-5 秒，上游波动时可能更长
- 非抖音官方授权 — 通过第三方基础设施访问公开数据，不走抖音开放平台
- 有限流 — 高并发可能被限速，agent 设计时按合理频率来
- 数据新鲜度因端点而异 — 热榜近实时，创作者分析可能滞后数小时
FAQ
SandBase 有多少个抖音接口？
截至 2026 年 7 月，310 个，分布在 10 个功能频道：搜索、创作者分析、热门指数、排行榜、星图（达人市场）、DOU+（推广）、App/Web 级视频数据。
一次调用要多少钱？
79% 的操作 $0.001/次。最贵的档（$0.25）是批量视频获取含完整元数据。一个每天监控 10 个账号的 agent 月费约 $0.90。
能做竞品监控吗？
能。组合用户资料、视频列表、视频详情端点，追踪发帖频率、互动趋势和内容策略变化。$0.001/次的价格下，10 个账号每天约 $0.03。
跟抖音官方 API 有什么区别？
抖音开放平台要求 OAuth 用户授权、应用审核（2-8 周），且只能访问授权用户自己的数据。SandBase 的抖音接口通过第三方基础设施访问公开数据——范围更广但没有抖音的官方背书。
返回什么格式？
标准 JSON 对象。同一个端点的字段名在不同调用间一致。Schema 可预测，可以为批量处理写类型化解析器。
关于抖音接口和其他社媒数据方式的对比，可以看 社媒数据 API 选型指南。
开始使用
如果你已经有 SandBase API Key，现在就能调任何抖音接口：
# 看看热门账号
curl -X POST https://api.sandbase.ai/v1/run \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "douyin/billboard/hot-account-list"}'310 个接口的完整列表在模型目录里。
有抖音生态相关的互补能力？联系我们——生态一直在扩展。
