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 详情 API | Space 状态、计划时间、主持人、发言人、收听和回放数据 | 每个 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。