X Community
X 社区是围绕某个主题组织的讨论空间，通常有社区名称、主题说明、成员数量和参与规则。这些资料可以帮助读者了解社区讨论什么、与其他社区相比规模如何，并在查看讨论前先确认参与政策。
主要特性
- 先了解社区讨论什么社区名称、公开说明、链接、封面和创建者信息会放在同一条记录中，便于确认是哪一个社区，并先阅读它介绍的讨论主题。
- 查看社区规模与参与政策结果提供成员和版主数量，以及描述加入方式的 join_policy 和描述成员邀请方式的 invites_policy，方便一起了解社区规模和参与条件。
- 读取社区自己的规则rules 列表包含规则名称和说明，便于将参与要求与社区基本资料一起保存，而不只保留一个社区名称。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填公开 X 社区链接列表，链接需要包含数字社区 ID，例如 https://x.com/i/communities/1493446837214187523；在 Playground 中每行填写一条链接，代码中使用 urls 数组，不填写个人主页、搜索页或单个帖子链接。 |
如何使用
提交后，数据会在后台收集，因此首次响应先返回任务编号 task_id；使用这个编号查询进度，等任务完成后再读取结果。
- 打开公开社区页面并复制含 /i/communities/ 的链接，为每个想查询的社区准备一条链接。
- 运行下方示例前，将 $SOCQ_API_KEY 替换为你自己的 API key，或先设置同名环境变量。按示例填写 Authorization 请求头，将 JSON 输入发送至 POST /v1/x/community，并保存响应中的 task_id。
- 将保存的编号填入 GET /v1/tasks/{task_id} 查询进度。queued 表示排队，running 表示处理中，retrying 表示正在重试；等到 succeeded 再读取结果，若状态为 failed 则查看 error_message 中的失败原因。
- 任务成功后，读取 data.results.items，其中每一项描述一个社区的资料。列表为空表示任务已完成，但没有返回记录。
- 若 data.results.has_more 为 true，next_cursor 的值就是下一页结果的标记。将它原样作为 cursor 参数填入 GET /v1/tasks/{task_id}?cursor=...，继续读取直到 has_more 为 false，即可取完该任务已保存的结果。
curl -X POST "https://api.socq.ai/v1/x/community" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'最佳使用场景
- 整理待了解的社区目录： 将社区名称、说明、链接和成员数量整理成表格，便于按主题和规模比较提交的社区，再选择要继续阅读的讨论。
- 为讨论查看保留社区背景： 按社区 ID 保存规则和成员加入政策，再通过 X Community Posts 单独获取帖子，将待查看的讨论与对应社区背景关联起来。
使用建议
- 从单个帖子开始查找时，先确认对应的公开社区链接，因为此查询不会根据帖子 URL 自动判断它属于哪个社区。
- 同一社区可能同时出现 x.com 和 twitter.com 链接，保存目录时使用 /i/communities/ 后面的数字 ID 关联，避免建立重复条目。
- 比较社区时，将成员数量作为规模信息，不要直接解释为发帖活跃程度；此结果不包含活动历史或逐个成员的名单。
相关 API
需要其他类型的 X 公开数据时，可以使用以下 API。
- Twitter Tweet Scraper API — 从 x.com 或 twitter.com status URL 获取公开帖子正文、作者、互动、媒体、标签、提及和会话关系。
- Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
- Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标，并排除回复。
- Twitter Search API — 按搜索表达式查找公开帖子，并支持 latest 或 top 排序和结果数量上限。
- X Followers List API — 按一个或多个 X 用户名采集公开关注者账号身份与可见资料指标。
- X Following List API — 采集 X 公开账号关注的个人资料，包括身份、简介、账号状态、可见计数和来源 username。
- X Post Quotes API — 按已知 status URL 采集公开引用帖，返回评论正文、作者、互动、媒体、时间和来源帖子上下文。
- X Post Replies API — 从 X 帖子 URL 采集公开回复，支持选择排序，并返回回复正文、作者、可见互动、媒体和父帖信息。
- X Post Retweeters API — 采集转发已知 X 或 Twitter status URL 的公开账号，并在整个任务中按账号去重后返回标准化主页记录。
- X Trends API — 按已知数字 WOEID 采集当前 X 公开趋势快照，保留来源排名、查询、描述和位置背景。
- Twitter Mentions API — 采集提及指定账号的公开帖子。
- Twitter User Search API — 按关键词查找 X 公开账号。
- X Community Posts API — 读取社区里的公开帖子，获取正文、作者和互动计数。
- X Thread Context API — 读取帖子及其回复链上的公开前文、后续回复和关系标识。