万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

今日头条

今日头条 API

围绕指定头条账号检索文章、视频与动态，读取内容正文和作者资料；保留阅读、播放等指标，供选题整理和内容索引使用。 调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始 看文档

4

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

今日头条 能力清单

action必填参数可选参数单次条数模式单价返回字段
articleurl——同步$0.56 / 千次id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · image_urls
profileuser_id——同步$0.56 / 千次user_id · nickname · bio · url · avatar_url · is_verified · verify_reason · platform
user_postsuser_idtab默认 20 · 最多 100同步$0.56 / 千次id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · image_urls
profile_searchuser_id, keyword—默认 20 · 最多 100同步$0.56 / 千次id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · image_urls

今日头条 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 今日头条 文章详情 API？

article

使用 platform="toutiao"、action="article" 调用“文章详情”能力；返回单个对象，主要包含 id、url、type、title、text、content_text 等 22 个字段。

今日头条 article 的参数分别是什么意思？

url必填
article 的具体文章或视频完整链接；在用户类接口中若同时提供 url 与 user_id，url 优先用于定位主页。

头条官方创作者帮助将文章列为独立内容形态，并说明标题、正文及发布管理流程；该资料没有规定 EveryInfra 可接受的公开文章 URL 格式，也没有提供任意文章详情公开读取 API。官方来源：今日头条：文章内容形态来源核查：

今日头条 特有返回字段与含义（8）
author_verified
作者是否认证。
author_auth_info
认证信息（如「XX领域创作者」）。
content_text
正文文本。
read_count
阅读量。
play_count
播放量。
cover
封面图。
region
地区。
source
来源。

怎么调用 今日头条 主页或对象详情 API？

profile

使用 platform="toutiao"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、nickname、bio、url、avatar_url、is_verified 等 8 个字段。

今日头条 profile 的参数分别是什么意思？

user_id必填
用户主页的 token/secUid，通常以 MS4w 开头，也可在 user_id 中传完整头条主页 URL；不是昵称或普通短数字 UID。

头条官方资料说明账号主页可包含头像、账号名和简介等资料；它不证明任意 user_id 或 secUid 可以公开读取，也不证明 EveryInfra 当前以 MS4w… token 或主页 URL 定位账号的规则。官方来源：今日头条：账号资料字段与公开读取边界来源核查：

今日头条 特有返回字段与含义（2）
nickname
作者昵称。
verify_reason
认证说明。

怎么调用 今日头条 用户内容 API？

user_posts

使用 platform="toutiao"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、type、title、text、content_text 等 22 个字段。

今日头条 user_posts 的参数分别是什么意思？

user_id必填
用户主页的 token/secUid，通常以 MS4w 开头，也可在 user_id 中传完整头条主页 URL；不是昵称或普通短数字 UID。
tab可选
user_posts 的主页栏目：all 全部（默认）、article 文章、video 视频、ugc 用户动态、short_video 短视频。它不控制文章详情类型。

头条创作者帮助中心把微头条说明为社交短内容，并单独介绍发布与修改流程。本接口按上方栏目说明读取作品，不因为引用这些流程就具备发文、编辑、参与话题或取得创作收益的能力。官方来源：今日头条：微头条与文章是不同内容形态来源核查：

今日头条 特有返回字段与含义（8）
author_verified
作者是否认证。
author_auth_info
认证信息（如「XX领域创作者」）。
content_text
正文文本。
read_count
阅读量。
play_count
播放量。
cover
封面图。
region
地区。
source
来源。
今日头条 article 调用流程一次 今日头条 article 调用的全过程：向 POST /api/v1/social 发送 platform="toutiao"、action="article"，以及必填参数 url;返回结构化 JSON，含 id、url、type、title、text 等字段；返回单个对象，计费 $0.56 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "toutiao"action: "article"urlEveryInfra$0.56 / 千次2 · 响应 · 对象idurltypetitletext
一次 今日头条 article 调用的全过程：向 POST /api/v1/social 发送 platform="toutiao"、action="article"，以及必填参数 url;返回结构化 JSON，含 id、url、type、title、text 等字段；返回单个对象，计费 $0.56 / 千次，失败与空结果不计费。

今日头条 原始字段名

EveryInfra 统一字段名

左边是 今日头条 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

今日头条 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 3 个字段名只在 今日头条 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • content_text
  • cover
  • author_auth_info

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
type
记录类型，取值随能力而定（如 video / image / text）。
title
标题。平台无标题概念时（如纯文本帖）为 null。
text
正文内容，已去除 HTML 标签。长文可能被截断。
content_text
正文文本。
cover
封面图。
read_count
阅读量。
play_count
播放量。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count
评论数。null 表示不公开，不等于 0。
share_count
分享/转发数。null 表示不公开，不等于 0。
source
来源。
author_name
作者昵称（显示名）。
author_id
作者在原平台的唯一 ID。
author_verified
作者是否认证。
author_auth_info
认证信息（如「XX领域创作者」）。
region
地区。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
user_id
用户在原平台的唯一 ID。
nickname
作者昵称。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
verify_reason
认证说明。

当前目录另列出 duration_sec · image_urls，这些字段尚无逐项释义；请先核对 今日头条 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

替换为实际文章链接；article 不接收关键词搜索词。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

toutiao_article.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"toutiao","action":"article","params":{"url":"https://www.toutiao.com/article/<ARTICLE_ID>/"}}'

记录字段预览（非真实响应）

仅展示 article 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "type": null,
  "title": null,
  "text": null,
  "content_text": null,
  "cover": null,
  "read_count": null,
  "play_count": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "source": null,
  "author_name": null,
  "author_id": null,
  "author_verified": null,
  "author_auth_info": null,
  "region": null,
  "posted_at": null,
  "platform": null,
  "duration_sec": null,
  "image_urls": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

读取今日头条文章或视频页面的元数据

用 article 查看一条内容，区分摘要、正文文字和互动计数。

查看 article 的 url 参数 →
  • url 填具体文章或视频链接；type 区分内容类型，text 是摘要，content_text 是去除 HTML 标签后的正文文字，视频条目不保证有语音文稿。
  • read_count 与 play_count 分别描述阅读和播放，comment_count 只是评论数量；本页没有评论正文或语音转写 action。posted_at 保留返回的发布时间文字，不假定已附时区。

核对头条主页 token 对应的账号身份

用 profile 获取轻量作者资料，不把它当作完整运营档案。

查看 profile 的 user_id 参数 →
  • user_id 填头条主页 token/secUid，通常以 MS4w 开头，也可填完整头条主页链接；不是昵称或普通短数字 UID，不能只因前缀相同就与其他平台 ID 混用。
  • 资料从取得的作品关联作者信息整理，返回 nickname、bio、url、is_verified 与 verify_reason；没有粉丝数或作品总数。没有关联内容时资料可能缺失，不直接判定账号不存在。

按头条主页栏目整理不同体裁的作品

用 user_posts 查看一个账号的投稿，保留文章、视频和动态的区别。

查看 user_posts 的 tab 参数 →
  • user_id 指定主页；tab=all 为默认全部，article 为文章，video 为视频，ugc 为用户动态，short_video 为短视频。栏目值不是 article 详情的类型开关。
  • id、url、type、title 与 posted_at 用于建索引；列表项的摘要或正文可能缺失，需要详情时继续用 article。不是发布、编辑或删除作品接口，也不保证全量历史。

在指定头条账号主页内搜索帖子

用 profile_search 找某个作者发布过的相关内容，不扩成全站检索。

查看 profile_search 的 keyword 参数 →
  • 同时提供 user_id 与 keyword；keyword 只在指定主页范围检索，不是今日头条全站搜索。本页也没有热榜或任意时间区间搜索 action。
  • 结果可能缺少 title 或 author_id，先保留 url / id，再用 article 查询详情并核对来源；read_count、play_count、like_count 只按实际返回记录，缺失不补零。

今日头条 API 常见问题

今日头条 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="toutiao"、action 和 params。以 article 为例，必填 url，没有可选参数。替换为实际文章链接；article 不接收关键词搜索词。 今日头条 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

今日头条 API 怎么收费？

$0.56 / 千次，今日头条 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 今日头条 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

今日头条 API 一次能返回多少条数据？

今日头条 有 2 个列表接口，包括 user_posts、profile_search。其余 2 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

今日头条 API 返回哪些字段？

当前目录为 article 列出 id、url、type、title、text、content_text 等 22 个字段名。按全站当前目录统计，3 个字段名只在 今日头条 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「读取今日头条文章或视频页面的元数据」怎样接入 今日头条 API？

用 article 查看一条内容，区分摘要、正文文字和互动计数。 url 填具体文章或视频链接；type 区分内容类型，text 是摘要，content_text 是去除 HTML 标签后的正文文字，视频条目不保证有语音文稿。 read_count 与 play_count 分别描述阅读和播放，comment_count 只是评论数量；本页没有评论正文或语音转写 action。posted_at 保留返回的发布时间文字，不假定已附时区。

「核对头条主页 token 对应的账号身份」怎样接入 今日头条 API？

用 profile 获取轻量作者资料，不把它当作完整运营档案。 user_id 填头条主页 token/secUid，通常以 MS4w 开头，也可填完整头条主页链接；不是昵称或普通短数字 UID，不能只因前缀相同就与其他平台 ID 混用。 资料从取得的作品关联作者信息整理，返回 nickname、bio、url、is_verified 与 verify_reason；没有粉丝数或作品总数。没有关联内容时资料可能缺失，不直接判定账号不存在。

「按头条主页栏目整理不同体裁的作品」怎样接入 今日头条 API？

用 user_posts 查看一个账号的投稿，保留文章、视频和动态的区别。 user_id 指定主页；tab=all 为默认全部，article 为文章，video 为视频，ugc 为用户动态，short_video 为短视频。栏目值不是 article 详情的类型开关。 id、url、type、title 与 posted_at 用于建索引；列表项的摘要或正文可能缺失，需要详情时继续用 article。不是发布、编辑或删除作品接口，也不保证全量历史。

「在指定头条账号主页内搜索帖子」怎样接入 今日头条 API？

用 profile_search 找某个作者发布过的相关内容，不扩成全站检索。 同时提供 user_id 与 keyword；keyword 只在指定主页范围检索，不是今日头条全站搜索。本页也没有热榜或任意时间区间搜索 action。 结果可能缺少 title 或 author_id，先保留 url / id，再用 article 查询详情并核对来源；read_count、play_count、like_count 只按实际返回记录，缺失不补零。

可以先免费试用 今日头条 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 今日头条 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 今日头条 API

加微信领 $1 免费额度，先选一个 今日头条 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始