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

社交内容 · 数据 API

X (Twitter)

X (Twitter) API

以关键词或账号 handle 检索 X 帖子，读取个人资料、单帖和会话回复样本，保留原文链接及互动计数，供讨论观察与内容整理使用。 调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始 看文档

8

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

X (Twitter) 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordsort默认 25 · 最多 200同步$0.56 / 千次id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
profileusername——同步$0.56 / 千次user_id · username · display_name · bio · url · follower_count · following_count · post_count · is_verified · location · avatar_url · created_at · platform
user_postsusername—默认 20 · 最多 200同步$0.56 / 千次id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
postidtweet_id—同步$0.56 / 千次id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
commentsidtweet_id默认 20 · 最多 50同步$0.56 / 千次id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
trending—country—同步$0.56 / 千次id · name · rank · volume · period · collected_at · platform
followers_listusername—默认 200 · 最多 2000同步$0.56 / 千次id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform
following_listusername—默认 200 · 最多 2000同步$0.56 / 千次id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform

X (Twitter) 每个接口分别做什么

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

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

怎么调用 X (Twitter) 主页或对象详情 API？

profile

使用 platform="twitter"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、username、display_name、bio、url、follower_count 等 13 个字段。

X (Twitter) profile 的参数分别是什么意思？

username必填
X 用户短名，可带 @，不要填完整主页 URL。profile 从最近帖子内的作者信息整理资料；followers_list 与 following_list 分别读取可见粉丝和关注账号，不保证完整关系网。

X 将 handle 与 display name 分开；handle 构成 @ 标识和主页链接，更改后原 handle 可能被他人使用。归档时不要只靠显示名或可变 handle 判断身份。官方来源：X：username / handle 与显示名来源核查：

怎么调用 X (Twitter) 用户内容 API？

user_posts

使用 platform="twitter"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、text、like_count、retweet_count、reply_count 等 13 个字段。

X (Twitter) user_posts 的参数分别是什么意思？

username必填
X 用户短名，可带 @，不要填完整主页 URL。profile 从最近帖子内的作者信息整理资料；followers_list 与 following_list 分别读取可见粉丝和关注账号，不保证完整关系网。

X 将 handle 与 display name 分开；handle 构成 @ 标识和主页链接，更改后原 handle 可能被他人使用。归档时不要只靠显示名或可变 handle 判断身份。官方来源：X：username / handle 与显示名来源核查：

X (Twitter) 特有返回字段与含义（1）
retweet_count
转发数。

怎么调用 X (Twitter) 单条内容 API？

post

使用 platform="twitter"、action="post" 调用“单条内容”能力；返回列表，主要包含 id、url、text、like_count、retweet_count、reply_count 等 13 个字段。

X (Twitter) post 的参数分别是什么意思？

id必填
post / comments 的数字帖子 ID，即 x.com/用户名/status/ 后的数字，建议用字符串保存以避免 JavaScript 大整数精度损失；不要把完整 URL 放入 id。

X 说明同一人多次查看可能计入多次浏览，部分帖子没有可用浏览次数。这里解释指标口径，不代表本接口能够访问受保护内容或私人分析数据。官方来源：X：浏览次数不等于独立用户数来源核查：

tweet_id可选
id 的兼容输入，优先级低于 id，不取消公开必填 id。
X (Twitter) 特有返回字段与含义（1）
retweet_count
转发数。

怎么调用 X (Twitter) 评论 API？

comments

使用 platform="twitter"、action="comments" 调用“评论”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、text、like_count、retweet_count、reply_count 等 13 个字段。

X (Twitter) comments 的参数分别是什么意思？

id必填
post / comments 的数字帖子 ID，即 x.com/用户名/status/ 后的数字，建议用字符串保存以避免 JavaScript 大整数精度损失；不要把完整 URL 放入 id。

X 的 conversation_id 指发起会话的原帖 ID，多层回复可共用它；重建父子关系还需要父帖标识。本接口未公开这些关系字段，不能把官方示例的完整回复树当作当前输出。官方来源：X：原帖 ID、会话 ID 与回复关系来源核查：

tweet_id可选
id 的兼容输入，优先级低于 id，不取消公开必填 id。
X (Twitter) 特有返回字段与含义（1）
retweet_count
转发数。

怎么调用 X (Twitter) 粉丝列表 API？

followers_list

使用 platform="twitter"、action="followers_list" 调用“粉丝列表”能力；返回列表，默认 200 条、单次最多 2000 条，主要包含 id、username、url、name、text、location 等 14 个字段。

X (Twitter) followers_list 的参数分别是什么意思？

username必填
X 用户短名，可带 @，不要填完整主页 URL。profile 从最近帖子内的作者信息整理资料；followers_list 与 following_list 分别读取可见粉丝和关注账号，不保证完整关系网。

X 分别说明谁关注了你、你关注了谁，关注不必相互；受保护帖子另有访问限制。名单查询不是批量关注操作，也不意味着访问权限扩大。官方来源：X：followers 与 following 的方向来源核查：

X (Twitter) 特有返回字段与含义（1）
is_protected
账号是否为受保护状态（推文仅粉丝可见）。

怎么调用 X (Twitter) 关注列表 API？

following_list

使用 platform="twitter"、action="following_list" 调用“关注列表”能力；返回列表，默认 200 条、单次最多 2000 条，主要包含 id、username、url、name、text、location 等 14 个字段。

X (Twitter) following_list 的参数分别是什么意思？

username必填
X 用户短名，可带 @，不要填完整主页 URL。profile 从最近帖子内的作者信息整理资料；followers_list 与 following_list 分别读取可见粉丝和关注账号，不保证完整关系网。

X 分别说明谁关注了你、你关注了谁，关注不必相互；受保护帖子另有访问限制。名单查询不是批量关注操作，也不意味着访问权限扩大。官方来源：X：followers 与 following 的方向来源核查：

X (Twitter) 特有返回字段与含义（1）
is_protected
账号是否为受保护状态（推文仅粉丝可见）。
X (Twitter) search 调用流程一次 X (Twitter) search 调用的全过程：向 POST /api/v1/social 发送 platform="twitter"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、text、like_count、retweet_count 等字段；返回列表，单次最多 200 条，计费 $0.56 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "twitter"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltextlike_countretweet_count
一次 X (Twitter) search 调用的全过程：向 POST /api/v1/social 发送 platform="twitter"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、text、like_count、retweet_count 等字段；返回列表，单次最多 200 条，计费 $0.56 / 千次，失败与空结果不计费。

X (Twitter) 原始字段名

EveryInfra 统一字段名

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

X (Twitter) 的独有字段名（当前目录）

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

  • retweet_count
  • period
  • collected_at
  • is_protected

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容，已去除 HTML 标签。长文可能被截断。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
retweet_count
转发数。
reply_count
回复数，通常用于评论的子回复。null 表示不公开。
view_count
浏览/播放数。null 表示不公开，不等于 0。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
author_username
作者用户名（@handle），通常可用于拼 URL。
author_name
作者昵称（显示名）。
author_url
作者在原平台的主页链接。
author_follower_count
作者粉丝数。null 表示不公开。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
user_id
用户在原平台的唯一 ID。
username
用户名（@handle）。
display_name
显示名，可能与 username 不同。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
follower_count
粉丝数。null 表示不公开，不等于 0。
following_count
关注数。null 表示不公开，不等于 0。
post_count
发布内容总数。null 表示不公开，不等于 0。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
location
地理位置描述，原文透传，格式随平台而异。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
created_at
创建时间，格式同 posted_at。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
rank
趋势榜名次。
volume
话题讨论量。
period
统计时段。
collected_at
该条数据的抓取时刻。趋势变化快，用它判断新鲜度。
is_protected
账号是否为受保护状态（推文仅粉丝可见）。

请求填写示例

这里检索公开帖子；不把结果数量上限当作全量历史保证。

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

twitter_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"twitter","action":"search","params":{"keyword":"open source"}}'

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

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

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "like_count": null,
  "retweet_count": null,
  "reply_count": null,
  "view_count": null,
  "posted_at": null,
  "author_username": null,
  "author_name": null,
  "author_url": null,
  "author_follower_count": null,
  "platform": null
}

常见用例

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

用 X 关键词收集帖子讨论样本

用 search 查询品牌名或话题词，保留原帖链接和作者 handle 便于复核。

查看 search 的 keyword 参数 →
  • keyword 是帖子查询文本，不是用户昵称搜索；结合 id、url、text、author_username、posted_at 与 reply_count 整理讨论样本。
  • 当前搜索默认按 Top 查询，不能依赖 sort=latest 获得稳定的最新排序；返回样本不代表全站完整命中量，回复数也不是不同参与者人数。

区分 X 账号 handle 与显示名

用 profile 核对账号标识、简介和公开数量，而不是按显示名猜同一个人。

查看 profile 的 username 参数 →
  • username 填 handle，可带前导 @，不要填完整主页 URL 或 display_name；结合 user_id、username、display_name、bio 与 follower_count 保存资料。
  • 当前资料从取得的帖子作者信息中提取，没有可用帖子时可能为空；is_verified 没有细分标记类型，不能直接认定为官方身份认证，缺失数量也不应补成零。

按 X 作者 handle 观察发帖内容

用 user_posts 读取指定作者的帖子，建立自己的发布时间与主题记录。

查看 user_posts 的 username 参数 →
  • username 填账号 handle，当前请求按作者查询并使用 Latest；结合 id、text、posted_at、author_username 与 retweet_count 归档。
  • posted_at 是帖子创建时间，不是编辑时间；此接口没有公开图片、视频文件或完整编辑记录字段，也不保证该账号全部历史帖子。

核对一条 X 帖子的正文与浏览次数

用 post 按 status 链接中的帖子 ID 读取正文和公开互动指标。

查看 post 的 id 参数 →
  • id 填 /status/ 后的数字字符串，避免长整数在 JavaScript 中失真；即使输入一个 ID，当前结果仍按列表处理，结合 id、url、text、like_count 与 view_count 核对。
  • view_count 是浏览次数，不是独立用户数，同一人可能贡献多次浏览；字段缺失不记为零，也不能用它推算准确触达人数或点击转化。

读取 X 原帖下的会话回复样本

用 comments 以发起会话的原帖 ID 查询回复，保留每条回复自己的链接。

查看 comments 的 id 参数 →
  • id 使用会话原帖 ID，而不是任意一条中途回复的 ID；结合返回的 id、url、text、author_username 与 posted_at 阅读上下文。
  • 当前返回平铺帖子，没有 conversation_id、父帖 ID 或嵌套 replies 字段；不能据此保证只含直接回复、完整回复树或全部评论，也不是发布回复的接口。

区分 X 地区趋势与个人推荐榜

用 trending 查看选定地区的当前趋势快照，再回查相关帖子理解话题。

查看 trending 的 country 参数 →
  • country 选择地区，例如 world、us 或 jp；默认 world，未识别的输入也回到 world，不能把任意国家名都当作受支持。结合 name、rank、volume、period 与 collected_at 留存快照。
  • rank 是当前返回条目的顺序，不是可比较的官方热度分数；volume 与 period 可能缺失，不能当成独立参与人数。此请求不带个人兴趣设置，也没有历史日期参数。

查看哪些 X 账号关注了目标账号

用 followers_list 整理关注目标账号的公开用户样本，方向与 following_list 相反。

查看 followers_list 的 username 参数 →
  • username 填目标 handle，不是显示名；结合 id、username、follower_count 与 is_protected 核对返回账号。当前 limit 小于 200 时请求目标仍按 200 处理，上限 2000，但实际返回可能更少。
  • 列表长度不能代替目标账号的粉丝总数；is_protected 仅表示账号的保护状态，不赋予读取受保护帖子的权限，也不保证完整关注关系图。

查看目标 X 账号关注了谁

用 following_list 观察目标账号的关注方向，避免与它的粉丝名单混用。

查看 following_list 的 username 参数 →
  • username 填目标 handle，可带 @；返回 id、username、name、text 与 following_count。text 是账号简介，最多保留 500 字符，不是该账号最近一条帖子。
  • 此接口只读取名单，不执行关注操作；limit 的请求目标为 200–2000，实际数量受可用结果限制。关注是有方向的关系，不代表双方互关或彼此背书。

X (Twitter) API 常见问题

X (Twitter) API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="twitter"、action 和 params。以 search 为例，必填 keyword，可选 sort。这里检索公开帖子；不把结果数量上限当作全量历史保证。 X (Twitter) 共 8 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

X (Twitter) API 怎么收费？

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

X (Twitter) API 一次能返回多少条数据？

X (Twitter) 有 7 个列表接口，包括 search、user_posts、post、comments、trending、followers_list、following_list。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

X (Twitter) API 返回哪些字段？

当前目录为 search 列出 id、url、text、like_count、retweet_count、reply_count 等 13 个字段名。按全站当前目录统计，4 个字段名只在 X (Twitter) 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「用 X 关键词收集帖子讨论样本」怎样接入 X (Twitter) API？

用 search 查询品牌名或话题词，保留原帖链接和作者 handle 便于复核。 keyword 是帖子查询文本，不是用户昵称搜索；结合 id、url、text、author_username、posted_at 与 reply_count 整理讨论样本。 当前搜索默认按 Top 查询，不能依赖 sort=latest 获得稳定的最新排序；返回样本不代表全站完整命中量，回复数也不是不同参与者人数。

「区分 X 账号 handle 与显示名」怎样接入 X (Twitter) API？

用 profile 核对账号标识、简介和公开数量，而不是按显示名猜同一个人。 username 填 handle，可带前导 @，不要填完整主页 URL 或 display_name；结合 user_id、username、display_name、bio 与 follower_count 保存资料。 当前资料从取得的帖子作者信息中提取，没有可用帖子时可能为空；is_verified 没有细分标记类型，不能直接认定为官方身份认证，缺失数量也不应补成零。

「按 X 作者 handle 观察发帖内容」怎样接入 X (Twitter) API？

用 user_posts 读取指定作者的帖子，建立自己的发布时间与主题记录。 username 填账号 handle，当前请求按作者查询并使用 Latest；结合 id、text、posted_at、author_username 与 retweet_count 归档。 posted_at 是帖子创建时间，不是编辑时间；此接口没有公开图片、视频文件或完整编辑记录字段，也不保证该账号全部历史帖子。

「核对一条 X 帖子的正文与浏览次数」怎样接入 X (Twitter) API？

用 post 按 status 链接中的帖子 ID 读取正文和公开互动指标。 id 填 /status/ 后的数字字符串，避免长整数在 JavaScript 中失真；即使输入一个 ID，当前结果仍按列表处理，结合 id、url、text、like_count 与 view_count 核对。 view_count 是浏览次数，不是独立用户数，同一人可能贡献多次浏览；字段缺失不记为零，也不能用它推算准确触达人数或点击转化。

可以先免费试用 X (Twitter) API 吗？

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

更多社交内容 API

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

开始调用 X (Twitter) API

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

免费开始