X (Twitter)

X (Twitter) API

以关键词或账号 handle 检索 X 帖子,读取个人资料、单帖和会话回复样本,保留原文链接及互动计数,供讨论观察与内容整理使用。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 twitter,action 填下方列表里的能力名,例如 search。

  • 21 个能力
  • 每千次 $0.56 起
  • 失败和空结果都不收费
  • 24h 健康值 91%

平台运行状态

24h 健康值
91%
健康

30 天趋势

X (Twitter) 能力清单

能力做什么单价24 小时运行状态
关键词搜索search用 search 查询品牌名或话题词,保留原帖链接和作者 handle 便于复核。$0.56 / 千次健康 · 健康值 100%
主页或对象详情profile用 profile 核对账号标识、简介和公开数量,而不是按显示名猜同一个人。$0.56 / 千次正常
用户内容user_posts用 user_posts 读取指定作者的帖子,建立自己的发布时间与主题记录。$0.56 / 千次健康 · 健康值 100%
单条内容post用 post 按 status 链接中的帖子 ID 读取正文和公开互动指标。$0.56 / 千次正常
评论comments用 comments 以发起会话的原帖 ID 查询回复,保留每条回复自己的链接。$0.56 / 千次正常
热榜trending用 trending 查看选定地区的当前趋势快照,再回查相关帖子理解话题。$0.56 / 千次正常
粉丝列表followers_list用 followers_list 整理关注目标账号的公开用户样本,方向与 following_list 相反。$0.56 / 千次正常
关注列表following_list用 following_list 观察目标账号的关注方向,避免与它的粉丝名单混用。$0.56 / 千次正常
媒体帖子user_media用 user_media 读账号主页「媒体」标签页里的帖子,也就是带图片或视频的帖子,从新到旧。$0.81 / 千次正常
回复帖子user_replies用 user_replies 读账号主页「回复」标签页,拿到它自己发的回复帖,从新到旧。$0.81 / 千次正常
转推用户retweeters用 retweeters 按帖子 ID 列出转推了这条帖子的账号,带粉丝数和发帖数。$0.81 / 千次正常
按 ID 批量查资料profiles_by_ids用 profiles_by_ids 一次按最多 20 个数字用户 ID 查账号,拿到用户名、名字、认证和账号状态。$0.81 / 千次正常
账号所在地与改名记录user_about用 user_about 读账号的「关于此账号」页:账号所在国家、注册来源、改名次数和认证起始时间。$0.81 / 千次正常
是否关注check_follow用 check_follow 判断 username 是否关注了 target_username,返回 true 或 false。$0.81 / 千次正常
是否转推check_retweet用 check_retweet 判断 username 是否转推了 id 指向的帖子,返回 true 或 false。$0.81 / 千次正常
社群资料community_info用 community_info 按社群 ID 读社群名称、简介、话题、成员数和社群规则。$0.81 / 千次正常
社群搜索search_communities用 search_communities 按关键词搜 X 的社群,带成员数和话题。$0.81 / 千次正常
用户搜索search_users用 search_users 按关键词搜 X 账号(「用户」标签页),按用户名、显示名和简介匹配。$0.56 / 千次暂不可用
视频口播文稿video_transcript用 video_transcript 把 X 视频帖里的口播转成一段文字。$0.96 / 千次正常
推文自串thread用 thread 给一条帖子链接,拿到作者自己从第一条起连发的整串帖子。$2.15 / 千次暂不可用
社群帖子community_posts用 community_posts 按社群 ID 读社群里的最新帖子,带互动数和作者。$0.81 / 千次正常

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

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

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

所有能力都是同步调用。

能力必填参数可选参数单次条数单价返回字段
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 · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · 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 · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · 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 · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · 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 · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · 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
user_mediausernamepage_token每页 12 条$0.81 / 千次next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_quote · is_repost · is_pinned · source · media · author_id · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
user_repliesusernamepage_token每页 30 条$0.81 / 千次next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
retweetersidpage_token, url每页 100 条$0.81 / 千次media_count · next_page_token · id · username · url · name · text · follower_count · following_count · post_count · platform
profiles_by_idsuser_ids—默认 20 · 最多 20$0.81 / 千次user_id · username · display_name · url · location · is_verified · is_protected · affiliation · avatar_url · created_at · account_status · platform
user_aboutusername——$0.81 / 千次user_id · username · display_name · url · account_based_in · is_location_accurate · signup_source · username_change_count · last_username_change_at · is_verified · verified_since · is_protected · affiliation · avatar_url · account_status · platform
check_followusername, target_username——$0.81 / 千次username · target_username · is_following · platform
check_retweetusername, idurl—$0.81 / 千次username · post_id · is_retweeted · platform
community_infocommunity_idurl—$0.81 / 千次id · url · name · description · topic · member_count · is_nsfw · banner_url · created_at · rules · platform
search_communitieskeywordpage_token每页 10 条$0.81 / 千次id · url · name · topic · member_count · is_nsfw · banner_url · platform · next_page_token
search_userskeywordpage_token每页 20 条$0.56 / 千次next_page_token · id · username · url · name · text · avatar_url · follower_count · following_count · post_count · is_verified · created_at · platform
video_transcripturlid—$0.96 / 千次id · url · text · word_count
threadurlid默认 100 · 最多 100$2.15 / 千次id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · reply_to_id · source · media · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_created_at · author_banner_url · platform
community_postscommunity_idpage_token, url每页 20 条$0.81 / 千次next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · quote_count · language · is_quote · is_repost · is_pinned · source · media · author_id · author_is_verified · platform

怎么调用 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 等 38 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

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

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

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

X (Twitter) 返回字段与含义(12)
retweet_count
转发数。
bookmark_count
书签(收藏)数。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote
是否引用推文。
reply_to_user_id
所回复用户的数字 ID。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
mentions
正文里 @ 到的用户名。
links
正文里的外链(展开后的完整网址)。
author_post_count
作者推文总数。
author_media_count
作者发过的媒体数。
author_banner_url
作者主页横幅图链接。

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

post

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

查看完整接口文档:参数、代码示例、响应样例与健康状态

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

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

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

tweet_id可选
id 的兼容输入,优先级低于 id,不取消公开必填 id。
X (Twitter) 返回字段与含义(12)
retweet_count
转发数。
bookmark_count
书签(收藏)数。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote
是否引用推文。
reply_to_user_id
所回复用户的数字 ID。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
mentions
正文里 @ 到的用户名。
links
正文里的外链(展开后的完整网址)。
author_post_count
作者推文总数。
author_media_count
作者发过的媒体数。
author_banner_url
作者主页横幅图链接。

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

comments

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

查看完整接口文档:参数、代码示例、响应样例与健康状态

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) 返回字段与含义(12)
retweet_count
转发数。
bookmark_count
书签(收藏)数。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote
是否引用推文。
reply_to_user_id
所回复用户的数字 ID。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
mentions
正文里 @ 到的用户名。
links
正文里的外链(展开后的完整网址)。
author_post_count
作者推文总数。
author_media_count
作者发过的媒体数。
author_banner_url
作者主页横幅图链接。

怎么调用 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) 媒体帖子 API?

user_media

使用 platform="twitter"、action="user_media" 调用“媒体帖子”能力;返回列表,每次一页、固定 12 条,更多用 next_page_token 翻页,主要包含 next_page_token、id、url、text、like_count、retweet_count 等 31 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X (Twitter) user_media 的参数分别是什么意思?

username必填
X 用户短名,可带 @,也可填主页链接 https://x.com/<用户名>;取这个账号主页「媒体」页的帖子(带图片或视频的)。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。
X (Twitter) 返回字段与含义(9)
retweet_count
转发数。
bookmark_count
书签(收藏)数。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote
是否引用推文。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
author_post_count
作者推文总数。
author_media_count
作者发过的媒体数。
author_banner_url
作者主页横幅图链接。

怎么调用 X (Twitter) 回复帖子 API?

user_replies

使用 platform="twitter"、action="user_replies" 调用“回复帖子”能力;返回列表,每次一页、固定 30 条,更多用 next_page_token 翻页,主要包含 next_page_token、id、url、text、like_count、retweet_count 等 36 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X (Twitter) user_replies 的参数分别是什么意思?

username必填
X 用户短名,可带 @,也可填主页链接;取这个账号主页「回复」页里本人发的帖子(多数是回复,也含本人的普通帖子)。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。
X (Twitter) 返回字段与含义(10)
retweet_count
转发数。
bookmark_count
书签(收藏)数。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote
是否引用推文。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
mentions
正文里 @ 到的用户名。
links
正文里的外链(展开后的完整网址)。
author_post_count
作者推文总数。
author_media_count
作者发过的媒体数。
author_banner_url
作者主页横幅图链接。

怎么调用 X (Twitter) 转推用户 API?

retweeters

使用 platform="twitter"、action="retweeters" 调用“转推用户”能力;返回列表,每次一页、固定 100 条,更多用 next_page_token 翻页,主要包含 media_count、next_page_token、id、username、url、name 等 11 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Get Reposted By 按帖子 ID 列出转推了它的用户,每页 max_results 最多 100、用 pagination_token 翻页。可证明「转推者」是按帖子 ID 定位的用户列表;不证明本接口和官方接口覆盖一致,也不证明 check_retweet 的判断规则。官方来源:X API:转推了一条帖子的用户(Get Reposted By)来源核查:

X (Twitter) retweeters 的参数分别是什么意思?

id必填
数字帖子 ID(x.com/用户名/status/ 后的数字),也可填帖子链接;返回转推了这条帖子的账号,每页约 100 个。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。
url可选
兼容写法,可以不传:帖子链接直接填进必填的 id 即可;id 和 url 都填时以 id 为准。
X (Twitter) 返回字段与含义(1)
media_count
账号发过的图片 / 视频数(retweeters)。

怎么调用 X (Twitter) 按 ID 批量查资料 API?

profiles_by_ids

使用 platform="twitter"、action="profiles_by_ids" 调用“按 ID 批量查资料”能力;返回列表,默认 20 条、单次最多 20 条,主要包含 user_id、username、display_name、url、location、is_verified 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

user_ids 放 1–20 个数字用户 ID;按一次调用计费,不按个数。

JSON
{
  "platform": "twitter",
  "action": "profiles_by_ids",
  "params": {
    "user_ids": [
      "44196397",
      "11348282"
    ]
  }
}

X 官方 API 文档的 Get Users by IDs 按数字用户 ID 一次取多个用户(官方 ids 1–100 个)。可证明数字用户 ID 是账号的稳定标识、可批量查询;本接口一次最多 20 个,返回字段以本接口契约为准。官方来源:X API:按用户 ID 批量取账号(Get Users by IDs)来源核查:

X (Twitter) profiles_by_ids 的参数分别是什么意思?

user_ids必填
数字用户 ID 数组(或逗号分隔的字符串),一次 1–20 个;按一次调用计费,不按个数。
X (Twitter) 返回字段与含义(3)
is_protected
账号是否为受保护状态(推文仅粉丝可见)。
affiliation
账号挂的机构标签(如员工账号挂的公司名「X」);没挂时没有这个字段。
account_status
账号状态,正常是 active(被封或停用时为其他值)。

怎么调用 X (Twitter) 账号所在地与改名记录 API?

user_about

使用 platform="twitter"、action="user_about" 调用“账号所在地与改名记录”能力;返回单个对象,主要包含 user_id、username、display_name、url、account_based_in、is_location_accurate 等 16 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X (Twitter) user_about 的参数分别是什么意思?

username必填
X 用户短名,可带 @,也可填主页链接;返回这个账号「关于此账号」页的信息。
X (Twitter) 返回字段与含义(9)
is_protected
账号是否为受保护状态(推文仅粉丝可见)。
affiliation
账号挂的机构标签(如员工账号挂的公司名「X」);没挂时没有这个字段。
account_status
账号状态,正常是 active(被封或停用时为其他值)。
account_based_in
X「关于此账号」页显示的账号所在国家 / 地区(如 United States);X 没显示时没有这个字段。
is_location_accurate
X 是否认为 account_based_in 准确(false 表示可能用了代理或 VPN 等)。
signup_source
账号注册来源(如 United States App Store);X 没显示时没有这个字段。
username_change_count
账号改过几次用户名。
last_username_change_at
最近一次改用户名的时间;没改过时没有这个字段。
verified_since
账号开始拿到认证标记的时间。

怎么调用 X (Twitter) 是否关注 API?

check_follow

使用 platform="twitter"、action="check_follow" 调用“是否关注”能力;返回单个对象,主要包含 username、target_username、is_following、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Get Following 按用户 ID 列出这个账号关注的用户。可证明关注关系是从关注者一侧可查的对象;不证明本接口的判断方式或实时性。官方来源:X API:一个账号关注的用户(Get Following)来源核查:

X (Twitter) check_follow 的参数分别是什么意思?

username必填
要查的账号(关注者一方),X 用户短名,可带 @。
target_username必填
被关注的账号,X 用户短名,可带 @;查 username 有没有关注它。
X (Twitter) 返回字段与含义(2)
target_username
被查是否被关注的账号(check_follow 原样带回)。
is_following
username 是否关注了 target_username(check_follow)。

怎么调用 X (Twitter) 是否转推 API?

check_retweet

使用 platform="twitter"、action="check_retweet" 调用“是否转推”能力;返回单个对象,主要包含 username、post_id、is_retweeted、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Get Reposted By 按帖子 ID 列出转推了它的用户,每页 max_results 最多 100、用 pagination_token 翻页。可证明「转推者」是按帖子 ID 定位的用户列表;不证明本接口和官方接口覆盖一致,也不证明 check_retweet 的判断规则。官方来源:X API:转推了一条帖子的用户(Get Reposted By)来源核查:

X (Twitter) check_retweet 的参数分别是什么意思?

username必填
要查的账号,X 用户短名,可带 @。
id必填
数字帖子 ID,也可填帖子链接;查 username 有没有转推这条帖子。
url可选
兼容写法,可以不传:帖子链接直接填进必填的 id 即可;id 和 url 都填时以 id 为准。
X (Twitter) 返回字段与含义(1)
is_retweeted
username 是否转推过这条帖子(check_retweet)。

怎么调用 X (Twitter) 社群资料 API?

community_info

使用 platform="twitter"、action="community_info" 调用“社群资料”能力;返回单个对象,主要包含 id、url、name、description、topic、member_count 等 11 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Get Community by ID 按社群数字 ID 返回社群名称、简介、加入方式和 member_count。可证明社群由数字 ID 定位、带成员数;不证明社群规则、横幅或社群内帖子列表的字段。官方来源:X API:按 ID 取社群(Get Community by ID)来源核查:

X (Twitter) community_info 的参数分别是什么意思?

community_id必填
社群(Communities)的数字 ID,即 x.com/i/communities/ 后的数字,也可填社群链接。
url可选
兼容写法,可以不传:社群链接直接填进必填的 community_id 即可;两个都填时以 community_id 为准。
X (Twitter) 返回字段与含义(4)
topic
社群的主话题(如 Finance)。
is_nsfw
社群是否标为成人内容。
banner_url
社群横幅图链接。
rules
社群规则(每条的标题)。

怎么调用 X (Twitter) 社群搜索 API?

search_communities

使用 platform="twitter"、action="search_communities" 调用“社群搜索”能力;返回列表,每次一页、固定 10 条,更多用 next_page_token 翻页,主要包含 id、url、name、topic、member_count、is_nsfw 等 9 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Search Communities 用 query 搜索社群,返回社群名称、ID 和 member_count,带 next_token 翻页。可证明社群可按关键词搜索;不证明匹配规则、排序或每页数量与本接口一致。官方来源:X API:搜索社群(Search Communities)来源核查:

X (Twitter) search_communities 的参数分别是什么意思?

keyword必填
搜索社群用的关键词,按社群名称和话题匹配。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。
X (Twitter) 返回字段与含义(3)
topic
社群的主话题(如 Finance)。
is_nsfw
社群是否标为成人内容。
banner_url
社群横幅图链接。

怎么调用 X (Twitter) 用户搜索 API?

search_users

使用 platform="twitter"、action="search_users" 调用“用户搜索”能力;返回列表,每次一页、固定 20 条,更多用 next_page_token 翻页,主要包含 next_page_token、id、username、url、name、text 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Search Users 用 query 搜索账号并带 next_token 翻页。可证明账号可以按关键词搜索、返回的是用户而不是帖子;不证明匹配规则、排序或返回字段与本接口一致。官方来源:X API:搜索用户(Search Users)来源核查:

X (Twitter) search_users 的参数分别是什么意思?

keyword必填
搜账号用的关键词:话题(如 ai agents)、人名或用户名,按用户名、显示名和简介匹配(X 搜索的「用户」页);返回账号,不返回帖子。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。

怎么调用 X (Twitter) 视频口播文稿 API?

video_transcript

使用 platform="twitter"、action="video_transcript" 调用“视频口播文稿”能力;返回单个对象,主要包含 id、url、text、word_count。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X (Twitter) video_transcript 的参数分别是什么意思?

url必填
视频帖链接 https://x.com/<用户名>/status/<数字 ID>,或数字帖子 ID;返回视频里说话内容的文字稿。
id可选
url 的兼容输入:数字帖子 ID。

怎么调用 X (Twitter) 推文自串 API?

thread

使用 platform="twitter"、action="thread" 调用“推文自串”能力;返回列表,默认 100 条、单次最多 100 条,主要包含 id、url、text、like_count、retweet_count、reply_count 等 28 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X (Twitter) thread 的参数分别是什么意思?

url必填
帖子链接 https://x.com/<用户名>/status/<数字 ID>,或数字帖子 ID;可以是自串里的任意一条,返回从根帖起整串作者自己连发的帖子。
id可选
url 的兼容输入:数字帖子 ID。
X (Twitter) 返回字段与含义(6)
retweet_count
转发数。
bookmark_count
书签(收藏)数。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
author_banner_url
作者主页横幅图链接。

怎么调用 X (Twitter) 社群帖子 API?

community_posts

使用 platform="twitter"、action="community_posts" 调用“社群帖子”能力;返回列表,每次一页、固定 20 条,更多用 next_page_token 翻页,主要包含 next_page_token、id、url、text、like_count、retweet_count 等 22 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

X 官方 API 文档的 Get Community by ID 按社群数字 ID 返回社群名称、简介、加入方式和 member_count。可证明社群由数字 ID 定位、带成员数;不证明社群规则、横幅或社群内帖子列表的字段。官方来源:X API:按 ID 取社群(Get Community by ID)来源核查:

X (Twitter) community_posts 的参数分别是什么意思?

community_id必填
社群的数字 ID,也可填社群链接 https://x.com/i/communities/<id>;返回社群里的最新帖子。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。
url可选
兼容写法,可以不传:社群链接直接填进必填的 community_id 即可;两个都填时以 community_id 为准。
X (Twitter) 返回字段与含义(4)
retweet_count
转发数。
is_quote
是否引用推文。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
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) 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

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

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

  • retweet_count
  • conversation_id
  • is_quote
  • reply_to_user_id
  • author_post_count
  • author_media_count
  • author_banner_url
  • period
  • collected_at
  • is_protected
  • affiliation
  • account_status
  • account_based_in
  • is_location_accurate
  • signup_source
  • username_change_count
  • last_username_change_at
  • verified_since

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/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 表示不公开。
bookmark_count
书签(收藏)数。
language
内容语言代码(如 zh、en),由平台判定,可能不准。
conversation_id
所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote
是否引用推文。
reply_to_user_id
所回复用户的数字 ID。
source
发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media
推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
hashtags
正文里的话题标签数组,按出现顺序;没有时不出现这个字段。
mentions
正文里 @ 到的用户名。
links
正文里的外链(展开后的完整网址)。
author_id
作者在原平台的唯一 ID。
author_avatar_url
作者头像图片链接(多数平台带签名、会过期)。
author_post_count
作者推文总数。
author_media_count
作者发过的媒体数。
author_banner_url
作者主页横幅图链接。
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
账号是否为受保护状态(推文仅粉丝可见)。
media_count
账号发过的图片 / 视频数(retweeters)。
affiliation
账号挂的机构标签(如员工账号挂的公司名「X」);没挂时没有这个字段。
account_status
账号状态,正常是 active(被封或停用时为其他值)。
account_based_in
X「关于此账号」页显示的账号所在国家 / 地区(如 United States);X 没显示时没有这个字段。
is_location_accurate
X 是否认为 account_based_in 准确(false 表示可能用了代理或 VPN 等)。
signup_source
账号注册来源(如 United States App Store);X 没显示时没有这个字段。
username_change_count
账号改过几次用户名。
last_username_change_at
最近一次改用户名的时间;没改过时没有这个字段。
verified_since
账号开始拿到认证标记的时间。
target_username
被查是否被关注的账号(check_follow 原样带回)。
is_following
username 是否关注了 target_username(check_follow)。
is_retweeted
username 是否转推过这条帖子(check_retweet)。
description
简介或描述,通常比 text 短。
topic
社群的主话题(如 Finance)。
is_nsfw
社群是否标为成人内容。
banner_url
社群横幅图链接。
rules
社群规则(每条的标题)。

当前目录另列出 quote_count · is_reply · is_repost · is_pinned · reply_to_id · reply_to · author_bio · author_is_verified · author_following_count · author_created_at · next_page_token · post_id · member_count · word_count,这些字段尚无逐项释义;请先核对 X (Twitter) 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

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

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

twitter_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_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,
  "quote_count": null,
  "bookmark_count": null,
  "language": null,
  "conversation_id": null,
  "is_reply": null,
  "is_quote": null,
  "is_repost": null,
  "is_pinned": null,
  "reply_to_id": null,
  "reply_to_user_id": null,
  "reply_to": null,
  "source": null,
  "media": null,
  "hashtags": null,
  "mentions": null,
  "links": null,
  "author_id": null,
  "author_avatar_url": null,
  "author_bio": null,
  "author_is_verified": null,
  "author_following_count": null,
  "author_post_count": null,
  "author_media_count": null,
  "author_created_at": null,
  "author_banner_url": 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 是账号简介全文,不是该账号最近一条帖子。
  • 此接口只读取名单,不执行关注操作;limit 的请求目标为 200–2000,实际数量受可用结果限制。关注是有方向的关系,不代表双方互关或彼此背书。

X 媒体帖子 API 如何列出一个账号发的图片和视频帖?

用 user_media 读账号主页「媒体」标签页里的帖子,也就是带图片或视频的帖子,从新到旧。

查看 user_media 的 username 参数
  • username 填账号用户名,如 NASA(可带 @)。每页约 12 条、条数不固定,翻页把 next_page_token 作为 page_token 传回。
  • media 是图片和视频链接,like_count、retweet_count、reply_count、view_count 是互动数;author_follower_count 是作者粉丝数。

X 回复 API 如何读一个账号发过的回复?

用 user_replies 读账号主页「回复」标签页,拿到它自己发的回复帖,从新到旧。

查看 user_replies 的 username 参数
  • username 填账号用户名(可带 @)。只返回这个账号自己的帖子,被回复的原帖不在结果里;reply_to_id 是它回复的那条帖子的 ID。
  • 每页约 30 条、条数不固定,翻页把 next_page_token 作为 page_token 传回。hashtags、mentions、links 只在帖子里有时出现。

X 转推用户 API 如何列出转发了某条帖子的账号?

用 retweeters 按帖子 ID 列出转推了这条帖子的账号,带粉丝数和发帖数。

查看 retweeters 的 id 参数
  • id 填帖子数字 ID(链接里 /status/ 后面的数字),也可以填帖子链接。
  • 每页最多 100 个,翻页把 next_page_token 作为 page_token 传回。只列 X 仍在显示的转推。

X 批量账号 API 如何按数字用户 ID 一次查多个账号?

用 profiles_by_ids 一次按最多 20 个数字用户 ID 查账号,拿到用户名、名字、认证和账号状态。

查看 profiles_by_ids 的 user_ids 参数
  • user_ids 填数字用户 ID 数组或逗号分隔的字符串,一次 1–20 个。
  • account_status 是账号状态;这里没有简介和粉丝数,要这些就拿返回的 username 再调 profile。

X「关于此账号」API 如何查账号所在国家和改名次数?

用 user_about 读账号的「关于此账号」页:账号所在国家、注册来源、改名次数和认证起始时间。

查看 user_about 的 username 参数
  • username 填账号用户名(可带 @)。
  • account_based_in 是账号所在国家或地区,is_location_accurate 表示是否准确;username_change_count 是改名次数,last_username_change_at 是最近一次改名时间。很多账号没有国家或注册来源,这时不出现。

X 关注关系 API 如何判断一个账号是否关注了另一个?

用 check_follow 判断 username 是否关注了 target_username,返回 true 或 false。

查看 check_follow 的 target_username 参数
  • username 填可能在关注的账号,target_username 填被关注的账号,都可带 @。
  • is_following 是调用那一刻的关注关系。

X 转推判断 API 如何确认某账号是否转推了一条帖子?

用 check_retweet 判断 username 是否转推了 id 指向的帖子,返回 true 或 false。

查看 check_retweet 的 id 参数
  • username 填要查的账号(可带 @),id 填帖子数字 ID,也可以填帖子链接。
  • is_retweeted 是调用那一刻 X 显示的转推关系。

X 社群资料 API 如何读一个 Communities 社群的资料和规则?

用 community_info 按社群 ID 读社群名称、简介、话题、成员数和社群规则。

查看 community_info 的 community_id 参数
  • community_id 填社群数字 ID(链接 x.com/i/communities/ 后面的数字),也可以填社群链接。
  • member_count 是成员数,topic 是社群话题,rules 是社群规则列表,is_nsfw 标记成人内容。

X 社群搜索 API 如何按关键词找 Communities 社群?

用 search_communities 按关键词搜 X 的社群,带成员数和话题。

查看 search_communities 的 keyword 参数
  • keyword 填社群名称或话题词,如 crypto、photography。每页约 10 个,翻页把 next_page_token 作为 page_token 传回。
  • id 可以直接传给 community_info 或 community_posts 的 community_id。

X 社群帖子 API 如何读一个社群里的最新帖子?

用 community_posts 按社群 ID 读社群里的最新帖子,带互动数和作者。

查看 community_posts 的 community_id 参数
  • community_id 填社群数字 ID,也可以填社群链接 https://x.com/i/communities/<数字>。
  • 每页约 20 条,翻页把 next_page_token 作为 page_token 传回;author_is_verified 表示作者是否认证。

X 账号搜索 API 如何按关键词找账号?

用 search_users 按关键词搜 X 账号(「用户」标签页),按用户名、显示名和简介匹配。

查看 search_users 的 keyword 参数
  • keyword 填话题、人名或用户名,如 ai agents;返回账号,不返回帖子。
  • 每页约 20 个,翻页把 next_page_token 作为 page_token 传回;follower_count、post_count 是粉丝数和发帖数。

X 推文自串 API 如何读作者连发的整串帖子?

用 thread 给一条帖子链接,拿到作者自己从第一条起连发的整串帖子。

查看 thread 的 url 参数
  • url 填自串里任意一条帖子的链接,或数字帖子 ID;最多 100 条。
  • 只含作者本人连发的帖子,别人的回复不在结果里;conversation_id 是整串的会话 ID。

X 视频口播文稿 API 如何把视频帖里说的话转成文字?

用 video_transcript 把 X 视频帖里的口播转成一段文字。

查看 video_transcript 的 url 参数
  • url 填视频帖链接 https://x.com/<用户名>/status/<数字>,或数字帖子 ID。
  • text 是整段文稿,word_count 是词数;没有分段时间轴。不是视频帖或视频里没人说话时返回空结果。

X (Twitter) 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

做多平台口碑监控:从目标清单、评论身份和增量游标开始,设计可追溯的采集流程;用离线样本演示去重和采集缺口怎么发现,关键判断一律保留人工复核。

阅读完整文章
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章

X (Twitter) API 常见问题

X (Twitter) API 怎么调用?

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

X (Twitter) API 怎么收费?

每千次 $0.56 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 464 次 X (Twitter) 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

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

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

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

当前目录为 search 列出 id、url、text、like_count、retweet_count、reply_count 等 38 个字段名。按全站当前目录统计,22 个字段名只在 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 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 X (Twitter) 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 21 个能力。无需信用卡。

开始调用 X (Twitter) API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 X (Twitter) 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策