X Post Quotes API

X Post Quotes

主要特性

• 展开公开引用帖从一个或多个公开 status 链接出发，采集引用这些来源的公开帖子，而不是回复或仅转帖账号。
• 各来源独立设置上限每条来源帖子可请求 20 到 2,000 条记录，且必须按 20 递增；每个 status 使用独立的供应商游标。
• 标准化评论记录以统一结构返回引用正文、语言、作者、发布时间、采集时间、媒体、实体和可见互动指标。
• 来源追踪与去重在 extra 中保留提交链接和父帖子 ID，并在整个任务中对重复引用帖 ID 只保存一次。

参数

如何使用

提交已知的公开 status 链接，再轮询异步任务并分页读取标准化引用帖记录。

1. 准备路径中包含 /status/{数字ID} 的公开 x.com 或 twitter.com 链接。
2. 向 /v1/x/post-quotes POST urls 数组，可选填写 results_limit，并保存 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
4. 读取 data.results.items；has_more 为 true 时继续传入 next_cursor，该结果游标与供应商分页游标彼此独立。

X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"

curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"

# 轮询 GET /v1/tasks/{task_id}?limit=50
# data.results.has_more 为 true 时继续使用 data.results.next_cursor

最佳使用场景

• 研究引用时新增的观点： 整理公开作者在引用产品发布、公告、研究链接或活动帖子时补充的评论，形成可审核的数据集。
• 识别公开传播者： 结合引用作者和可见互动，比较哪些账号的表达方式获得了更明显的公开响应。
• 归档引用帖快照： 为一组明确的来源帖子保存评论、媒体引用、时间和采集时互动计数。

使用建议

• 提交前校验域名和数字 /status/ ID；主页、搜索页和不含 status 的链接会被拒绝。
• 按每条来源帖子估算 results_limit，而不是按整个任务估算：两个链接各请求 100 时，预估上限为 200 条。
• 即使多个提交来源都关联到同一引用帖，任务结果中同一引用帖 ID 也只会保存一次。
• 将请求数量视为上限而非完整性保证；已删除、受保护、受限或被排除出搜索的帖子可能不会出现。
• 存储时允许媒体、实体、会话与互动字段为空，比较持续变化的计数时应同时使用 collected_at。

相关 API