XTwitterX 列表X 社区X SpacesAPI 指南

X API 新接口:列表、社区、Spaces、长文与账号所在地

SocQ 新增 14 个 X(Twitter)接口:账号所在地、认证粉丝、关注关系查询、列表、社区、媒体与回复、长文、Spaces 和视频转文字。

SocQ更新于 2026年11月19日阅读约 7 分钟

SocQ 的 X 接口早已支持公开主页、帖子、时间线、搜索、回复、引用、粉丝和趋势,X/Twitter 采集指南 介绍了这些接口。2026-11-17,又有 14 个接口上线到 X 平台页。它们覆盖了基础接口触及不到的部分:“关于此账号”面板、列表、社区成员和管理员、用户的媒体和回复标签页、长文(Articles)、Spaces,以及视频中的语音。

本文按用途对它们分组,每个接口给出一条请求示例,并列出价格。

快速回答: 向 POST https://api.socq.ai/v1/x/<endpoint> 发送 JSON 请求体。保存返回的 task_id,轮询 GET /v1/tasks/{task_id} 直到 status 为 succeeded,再读取 data.results.items。14 个接口都是每条结果 0.7 credits($0.0035),只有视频转文字对长视频另有规则。

新 X 接口一览

1 SocQ credit = $0.005。没有基础费用,结果为空时不收费。

接口返回内容价格
X 账号所在地 API账号所在国家、连接 X 的方式、注册日期、改名次数每个账号 0.7 credits($0.0035)
X 认证粉丝 API关注某个主页的认证账号每个粉丝 0.7 credits($0.0035)
Twitter 关注关系查询 API最多 100 对账号的关注、被关注和互关标记每对 0.7 credits($0.0035)
X 列表推文 API列表时间线,按时间倒序,标记转发每条帖子 0.7 credits($0.0035)
X 列表成员 API列表中的账号,完整主页资料每个成员 0.7 credits($0.0035)
X 列表关注者 API关注列表的账号,完整主页资料每个关注者 0.7 credits($0.0035)
X 社区搜索 API匹配关键词的社区,含成员数和 URL每个社区 0.7 credits($0.0035)
X 社区成员 API社区成员,完整主页资料每个成员 0.7 credits($0.0035)
X 社区管理员 API社区的管理员和版主每位管理员 0.7 credits($0.0035)
Twitter 媒体采集 API账号媒体标签页的帖子,含最高画质文件每条帖子 0.7 credits($0.0035)
X 用户回复 API账号写的回复,每条附被回复的帖子每条回复 0.7 credits($0.0035)
X 长文 API长文标题、预览句、全文、封面和互动数据每篇长文 0.7 credits($0.0035)
X Spaces 详情 APISpace 状态、计划时间、主持人、发言人、收听和回放数据每个 Space 0.7 credits($0.0035)
Twitter 视频转文字 API帖子视频的语音文本及时长2 分钟以内的视频每条 0.7 credits($0.0035)

认证与异步任务流程

所有请求都用 API key 认证。提交、查询任务状态和读取结果使用同一个请求头:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

每次采集都作为后台任务运行:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

提交请求会立即返回 data.task_id 和 data.status。用这个 ID 轮询任务:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

当 status 为 succeeded 时,响应包含 result_count、credits_amount,以及 data.results.items 中第一页标准化记录。limit 默认 50,最大 500。如果 results.has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。失败的任务带有 error_message。

下面每个接口都接受可选的 callback_url。任务结束后,SocQ 会发送一次带任务摘要的 POST;记录仍从任务接口读取。客户端超时不会取消任务,请用同一个任务 ID 继续读取,不要重新提交。402 表示账户余额不足,429 表示 key 触发了频率或额度限制。

关于 results_limit: 认证粉丝以及列表和社区成员类接口中,它按每个输入计算,默认 100,必须是 20 到 2000 之间 20 的倍数。社区搜索中它必须是 10 到 500 之间 10 的倍数。

核查账号与关系

账号所在地 读取“关于此账号”面板:country、connected_via(例如 United States App Store 或 Web)、注册日期、username_changes_count 和 affiliate_username。可用于核查网红和发现协同账号。部分账号(例如许多政府账号)没有国家信息,仍会返回一行,country 为 null。(文档)

curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "BBCWorld"]}'

认证粉丝 返回 X 在“认证关注者”标签页显示的列表。每行是一个认证粉丝(actor),并关联到你查询的账号(related_actor)。可用来衡量受众中有影响力的部分,或从竞品的粉丝中建立外联名单。(文档)

curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["NASA"], "results_limit": 20}'

关注关系查询 把一个 username 与最多 100 个 usernames 比较。每一对返回 is_following、is_followed_by 和 is_mutual。可用来确认活动参与者是否关注了你的品牌。(文档)

curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'

读取 X 列表

三个接口都接收 /i/lists/{numeric_id} 格式的公开列表 URL。

列表推文 返回列表的时间线,按时间倒序。转发会保留,并用 is_repost 标记,附带 reposted_post_id 和 reposted_author,方便过滤。一次请求就能监测整个细分领域。(文档)

curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

列表成员 以完整主页资料导出列表中的账号,含简介、所在地、网站、认证状态以及粉丝、关注和帖子数。人工挑选的列表就是现成的拓客种子名单。(文档)

curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

列表关注者 以相同的主页结构返回订阅该列表的账号。关注一个列表是对其主题的明确兴趣表达,因此这些账号是精准的研究人群。(文档)

curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

梳理 X 社区

社区搜索 按关键词查找社区,含名称、成员数、横幅、is_nsfw 和社区 URL。(文档)

curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin", "results_limit": 20}'

把社区 URL(/i/communities/{numeric_id})传给 社区成员,即可得到其成员的完整主页资料。(文档)

curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'

社区管理员 一次请求返回整个管理团队,包括管理员。他们是赞助或 AMA 的联系人。(文档)

curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'

社区的简介和规则见 社区详情指南,社区帖子见 社区帖子指南。

采集账号的媒体和回复

两个接口都接收一个 username;results_limit 默认 20,取值 1 到 1000。

媒体采集 返回账号媒体标签页中的帖子,按时间倒序,含正文、互动、播放量和媒体文件。视频指向可用的最高画质 MP4。(文档)

curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "NASA", "results_limit": 20}'

用户回复 返回账号的回复标签页,按时间倒序。每条回复带 in_reply_to,包含被回复帖子的正文、作者、链接和时间,每一行都是一段完整的对话。(文档)

curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "results_limit": 20}'

完整的对话见 线程上下文指南。

读取长文、Spaces 和视频语音

长文 接收发布长文的帖子 URL(/{username}/status/{post_id}),返回 title、作为 summary 的预览句、text 中的全文、封面图、作者以及点赞、回复、引用和播放量。不是长文的帖子不返回行;如果所有 URL 都不是长文,任务失败且不计费。(文档)

curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'

Spaces 接收 /i/spaces/{space_id} 链接。每个 Space 返回标题、status(已计划、直播中或已结束)、scheduled_start_at、主持人、发言人、实时收听人数、回放次数和 is_replay_available。(文档)

curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

视频转文字 把帖子视频中的语音转成纯文本,并返回 duration_seconds。2 分钟以内的视频 0.7 credits。更长的视频按完整时长每开始一分钟 4 credits($0.02)计费,因此 3 分钟的视频为 12 credits($0.06)。没有视频的帖子不返回行,不计费。(文档)

curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'

相关 X 指南

要把 SocQ 与其他 X 数据服务商和官方 API 对比,请阅读 X API 价格与替代方案、7 个最佳 Twitter/X 抓取 API 和 TwitterAPI.io 替代方案。

常见问题

X 没有列出国家时,账号所在地 API 返回什么?

返回一行,country 为 null。connected_via 和注册日期等其他字段照常返回。

为什么 results_limit 必须是 20 的倍数?

这是认证粉丝、列表推文、列表成员、列表关注者和社区成员的规则:20 到 2000,以 20 为步长,按每个输入计算。社区搜索以 10 为步长,取值 10 到 500。

不是长文或没有视频的帖子会收费吗?

不会。这些帖子不返回行,你只为返回的行付费。如果发给长文 API 的 URL 都不是长文,任务失败且不计费。

长视频转文字多少钱?

2 分钟以内:0.7 credits。更长:按完整时长每开始一分钟 4 credits,因此 3 分钟为 12 credits,5 分钟为 20 credits($0.10)。

可以一次查询很多关注关系吗?

可以。关注关系查询一次请求可把一个账号与最多 100 个账号比较,每对 0.7 credits。

X API

使用公开的 X 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 X API