X Thread Context
X 线程通过回复关系连接帖子：一条帖子可以回应前一条消息，也可以继续收到后续回复，前文指沿这些回复关系向前追溯的帖子，而不是时间较早的任意帖子。把这些关系与正文和作者信息放在一起，可以帮助读者顺着讨论脉络阅读，理解单条消息是在怎样的背景下表达的。
主要特性
- 把选定帖子放回讨论中阅读使用帖子链接，可以取得目标消息、沿回复关系向前追溯的公开前文及可获取的后续回复，便于在阅读单条消息时补充它所处的讨论背景。
- 看懂哪些帖子属于同一讨论、谁在回复谁返回的帖子除了正文、作者和互动计数，还带有描述讨论关系的标识：conversation_id 表示它属于哪一次讨论，in_reply_to_id 表示它直接回复了哪条帖子，便于把分散的记录连接起来。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填公开 X 帖子链接列表，链接需要包含 /status/ 和后面的数字帖子 ID，例如 https://x.com/BaganiTohid/status/2110635249889919362；Playground 中每行填写一条，代码中使用 urls 数组，不填写主页或社区链接。 |
results_limit | 可选 | 可选的每个输入帖子的上下文记录数量上限，接受 1 到 2000 的整数，默认 100；例如提交两个帖子链接并填 20，会分别对两个帖子最多请求 20 条相关记录，不是两个帖子共享 20 条，实际数量可能更少。 |
如何使用
提交后，数据会在后台收集，因此首次响应先返回任务编号 task_id；使用这个编号查询进度，等任务完成后再读取结果。
- 复制想了解其背景的公开帖子链接，并设置每个帖子需要请求的上下文记录数量；有多个链接时，将它们分别放入 urls 列表。
- 运行下方示例前，将 $SOCQ_API_KEY 替换为你自己的 API key，或先设置同名环境变量。按示例填写 Authorization 请求头，将 JSON 输入发送至 POST /v1/x/thread-context，并保存响应中的 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/thread-context" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/BaganiTohid/status/2110635249889919362"],"results_limit":20}'最佳使用场景
- 为单条消息审阅补充阅读背景： 将目标帖与返回的前文、回复放在一起展示，并保留正文与作者，便于查看这条消息正在回应什么，而不只孤立地阅读它。
- 绘制已有帖子的回复关系图： 按 conversation_id 分组，再将每条记录的 in_reply_to_id 对应到另一条记录的 id，绘制已有回复连线；引用的帖子未返回时保留空缺。
- 准备会话摘要的原始材料： 保存正文、作者名称、时间和回复关系，整理为可供人工或单独软件处理的阅读材料，接口本身不生成完成的摘要。
使用建议
- 整理讨论阅读顺序时，先按关系 ID 连接帖子，再把发布时间作为辅助信息，因为仅按时间排序无法说明每条消息具体在回应谁。
- in_reply_to_id 指向的 ID 不在已保存记录中时，将它保留为缺失的连线，不要改连到其他帖子，也不要补造缺失正文。
- 同一讨论提交多个帖子链接时，合并保存的结果应按帖子 ID 去重，避免共同的前文在阅读材料中出现多次。
- 只需要选定帖子的回复时使用 X Post Replies，只需要帖子本身时使用 X Posts，不必获取周边上下文。
相关 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 API — 通过社区链接读取主题说明、成员数量、规则和加入政策。
- X Community Posts API — 读取社区里的公开帖子，获取正文、作者和互动计数。