今日头条公开数据 API | SandBase
用一套 REST API 读取今日头条公开的作者、文章、视频和评论数据。无需登录头条、无需 SDK——一个 SandBase 密钥,为 Agent 而生。

今日头条是一个中文内容推荐平台——一条由文章、视频和创作者账号组成的信息流,可以直接映射到媒体监测、作者研究和内容分析等场景。可要用程序去读这些数据,通常意味着逆向 App、周旋于 token,而且 App 一变你就得重写一遍采集器。
SandBase 的今日头条公开数据 API 免去了这些前置成本。它通过普通的 REST 端点读取头条公开的作者主页、文章、视频和评论——只用一个 SandBase API 密钥,不需要登录头条、也不需要 SDK。端点 API 参考是每个参数和响应信封(id/status/model/outputs[0].data)的权威来源;下面展示的业务载荷字段名只是一个示例结构、并非保证的 schema,请以一份真实响应为准核对。
这不是今日头条官方开放平台。 当你需要经过授权的会员操作,或需要有正式授权协议的数据时,请走头条官方渠道。当你的工作流需要用于研究和监测的公开、只读数据时,用 SandBase。想上手?获取 SandBase API 密钥,然后浏览头条端点。
先说结论
- 一套 API 即可读取今日头条公开的作者主页、文章、视频和评论。
- 本文的 Model API 端点用
POST /v1/api/toutiao/<path>调用——只传该端点的参数,无 SDK,一个SANDBASE_API_KEY。- 本轮文章接口传字符串 ID:app 用
group_id,web 用aweme_id。作者、视频和评论路由另作历史导航。- 只返回公开、只读数据。你这边无需发帖、无需平台登录或 OAuth、不涉及私有数据;用 SandBase API 密钥鉴权即可。
当前范围:一篇已知文章
2026-11-08 修订通过免费 inspect 和公开参考核对 app article-info、web article-info,没有执行付费业务请求。资料、视频、评论的广泛介绍保留自 2026-09-27 发布、2026-10-01 更新的总览,属于历史导航,不是当前执行验证。
原封面是概念插画,其中作者标签、数字、文章卡片和评论片段不是新抓到的 API 数据、受众测量或测试排名。下方历史截图也与本次免费契约核对分开。
app 文章记录用 group_id,web 用 aweme_id,都传已知头条文章 ID 字符串。作者研究教程提供经过检查的单次 Python 请求,及已有 Key、已连接 Agent、新项目三种路径;不会自动遍历文章、查作者、读评论或下载图片。
两个选定端点的基础价都为 $0.001,符合组织共享的每日 100 次合资格调用额度,在 UTC 00:00 重置。资格不是剩余额度,本次没有查余额或扣费,不能保证一次请求必定免费成功。
你需要哪种头条 API?
| 你的需求 | 选择 | 原因 |
|---|---|---|
| 发布、以会员身份操作,或使用账号授权数据 | 头条官方渠道 | 会员和账号级操作应通过头条直接进行。 |
| 读取公开作者、文章、视频或评论 | SandBase 头条公开数据 API | 普通 REST、一个 SandBase 密钥、结构化 JSON,面向只读工作流。 |
| 私有或仅账号可见的数据 | 两种公开方案都不适用 | 这类数据不在本篇公开数据指南范围内。 |
头条 API 能取到什么
目录按用途分组:
- 作者 — 按
user_id读取公开作者主页。 - 文章 — app 按
group_id读取,web 按aweme_id读取。 - 视频 — 按
group_id读取视频详情。 - 评论 — 按
group_id读取某内容项的评论。
动手前请以每个端点的线上 API 参考为准核对具体面和参数;可用性因端点而异。
历史头条目录。保留自旧总览,不是当前目录数量或本次业务执行。
头条提供什么,SandBase 补什么
公开数据来自头条,SandBase 不拥有或运营头条。统一鉴权简化入口,但每个端点仍需分别检查输入、业务状态、结构、可用性和预算。相同信封不能证明作者到评论的自动链路可用。选定文章接口用 message success,不套用资料示例中的 errno/err_no 通用规则。
快速上手:一个 app 文章记录
本地配置 SANDBASE_API_KEY,使用 Model API POST 路由,在 group_id 中传文章 ID 字符串。如果选 web,就把路径改为 toutiao/web/article-info,字段改成 aweme_id,不要自动把两个都跑一遍。新 Agent 可以接收 SKILL.md、quickstart.md和选定任务。
curl --fail-with-body --connect-timeout 10 --max-time 90 \
-X POST https://api.sandbase.ai/v1/api/toutiao/app/article-info \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"group_id":"7450114952884503059"}'这个有限时的 cURL 只打印响应,不校验业务成功;完整检查见文章教程。要求 completed、outputs[0].data 对象、精确的 message: "success" 和内层 data 对象,不默默补空数据。不要给选定路由强加 errno=0,也不能把资料端点的成功码当文章响应。
作者、标题或计数可能缺失;没有 user_info 不证明删除,公开短示例没列出的字段也不证明完整响应没有。空对象仍是明显不完整的数据,不是拼出来的作者资料。web content 是 HTML,示例不渲染,也不访问其中的链接。
旧资料 Python 保存在历史代码归档。下面原 JSON 是资料响应示意,不是新文章请求的输出,也不是本次执行结果;其中 errno 不能变成整个提供方的通用成功规则:
{
"id": "79661704-523a-455e-bd9b-c57be210ca1a",
"status": "completed",
"model": "toutiao/app/user-info",
"outputs": [
{
"data": {
"errno": 0,
"message": "success",
"data": {
"user_id": "…",
"name": "…",
"description": "…",
"followers_count": 0,
"followings_count": 0,
"publish_count": 0,
"digg_count": 0,
"avatar_url": "…"
}
}
}
]
}非 completed 就停止,然后按该请求的端点检查业务结构,不回退成空数据,也不记录原始错误正文。
历史 user-info 参考。保留自旧总览,不是当前目录数量或本次业务执行。
能力地图
旧总览保留的历史导航,本轮只核对两个 article-info 契约,资料、视频和评论的输入与执行未重新验证。
| 能力簇 | 代表端点 | 典型用途 |
|---|---|---|
| 作者主页 | toutiao/app/user-info | 创作者研究与受众规模评估 |
| 文章详情 | toutiao/app/article-info | 按 group_id 做内容分析 |
| 视频详情 | toutiao/app/video-info | 按 group_id 读取视频项 |
| 评论 | toutiao/app/comments | 互动与情感分析输入 |
分页方式因端点而异——评论端点接受一个 offset(以字符串传入)来遍历评论。请查阅每个端点的结构。
历史 app article-info 参数参考。保留自旧总览,不是当前目录数量或本次业务执行。
扩展作者或评论查询之前
从文章研究作者是一种应用设计,不是当前示例必须执行三次的前提。每一步分别检查标识、状态规则、字段读取、可用性和费用;每次都要验证,不能整条链路只判一次 status。本轮没有重新验证评论及其分页。
旧教程的三个链接包含两篇可用文章与一个删除记录,每篇可用文章读一页评论,重试之前计划七次调用。稀疏资料、缺少作者卡片、明确 delete 标志是不同情况,应保留区别,不默默丢记录,也不把缺少卡片全当删除。
常见用例
从文章研究作者
2026-10-01 实验中,一个特定 user-info 记录名称为空、49 粉丝,而文章卡片约558万,原因没有确认。这不能证明 user-info 普遍失败,也不能保证文章卡片总能补齐资料。已有文章时,可用 app article-info 检查可用发布者元数据,缺失仍保留未知。见单次文章教程与历史实验。
头条文章 API 做内容分析
用一个 group_id 读取 toutiao/app/article-info 拿文章详情。输入:一个 group_id。输出:一个文章详情对象。端点:article-info。
头条评论 API 做互动信号
用一个 group_id 加一个 offset 字符串运行 toutiao/app/comments 来遍历评论。输入:一个 group_id 加 offset。输出:一个评论负载。端点:comments。
解释之前,先保留首份响应
请求中的文章 ID 保持字符串。保存页面可能把大整数舍入,存在且已确认的 gidStr 字符串比舍入后的数字展示更适合核对;把舍入数字转字符串找不回丢失末位。捕获页面里的 $1d 等渲染引用也不是正文,不能把展示问题当新业务结果。
web 正文是 HTML,不是纯文本或现成摘要。教程保留原数据,不渲染、不访问媒体,也不继续调用评论或模型。应用需要文本时,应使用合适的 HTML 解析器并测试;正则去标签不是可靠全文提取或安全清洗。
缺失计数、数字零、认证 false 各有含义。分作者汇总或比较文章之前,先保留来源与未知项。粉丝数不等于文章触达,单篇阅读量也不能证明作者的典型受众。看完第一条记录及边界,再决定是否追加请求。
局限与边界
- 仅公开、只读数据。 不发帖、不关注、不涉及私有或仅账号可见的数据。
- 速率与量级。 出错先停,检查原因和预算后再决定是否重发;本例不自动重试。
- 参数与结构随上游面而定。 app 文章用
group_id,web 文章用aweme_id,历史作者接口用user_id;评论offset是字符串;选定文章接口检查 message success 与 data 对象,其他路由需另行核对。先看一次真实响应、读一遍结构。 - 以线上参考核对端点。 可用性和字段可能变化;在依赖某个具体端点前先确认。
- 这不是头条官方合作。 SandBase 提供对公开数据的统一访问;请就你的使用场景遵守头条条款和适用规则。
常见问题
我需要头条开发者应用或登录吗?
不需要。你用自己的 SANDBASE_API_KEY 向 SandBase 鉴权。这些读取端点不需要你这边有头条账号或 OAuth。
什么标识一个作者或一篇文章?
本轮选定的文章接口均传已知文章 ID 字符串,但参数名不同:app article-info 用 group_id,web article-info 用 aweme_id。历史作者接口使用 user_id;视频和评论参数仅作导航,本轮没有复验。
为什么响应里 data 内层还有一个 code?
业务状态按端点分别判断。选定 app/web 文章参考是 message success 加内层 data 对象;旧资料 JSON 展示 errno,但不是通用文章成功规则。
我能读私有或仅账号可见的数据吗? 不能。这套 API 只返回公开数据。私有和账号授权内容不在范围内。
从已知文章开始
配置或复用 Key,选择 app 或 web article-info,先检查经过校验的记录,再考虑扩大范围。准备好后:
觉得有用?分享给更多人