Twitter Mentions
追踪公开提及推文有助于及时掌握品牌声誉、客户咨询与舆情扩散态势。标准化提及记录包含帖子正文、发帖作者、发布时间、媒体附件及可见互动计数，无需账号授权即可便捷接入。
主要特性
- 公开提及全量追踪只需指定目标用户的公开 handle，即可抓取全网提及该账号的公开推文，无需目标账号授权。
- 支持起止时间窗口提供 start_date 与 end_date 筛选，支持标准 ISO 日期或 Unix 时间戳，精准框定监测时段。
- 完整推文与作者资料返回标准化的推文对象，包含正文全文、发帖人档案、媒体附件及推文永久直达链接。
- 全套互动指标自动提取点赞、评论、转发、引用、书签和浏览量计数，便于快速判断单条提及的传播量级。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
usernames | 必填 | 要查询提及的目标公开 X 用户名数组，可带或不带前导 @。 |
results_limit | 可选 | 每个用户名返回的提及推文数量上限；必须是 20 到 2,000 之间 20 的整数倍。 |
start_date | 可选 | 可选开始时间，支持 ISO 日期（YYYY-MM-DD）或 Unix 时间戳秒数，筛选该时间之后的推文。 |
end_date | 可选 | 可选结束时间，支持 ISO 日期（YYYY-MM-DD）或 Unix 时间戳秒数，筛选该时间之前的推文。 |
如何使用
提交目标用户名与可选时间区间作为异步任务，并轮询拉取提及推文。
- 在 usernames 中输入目标账号 handle，并将 results_limit 设为 20 的倍数（最高 2,000）。
- 按需配置 start_date 与 end_date 限定采集时间范围。
- 向 /v1/x/mentions 发送 POST 请求。
- 轮询 /v1/tasks/{task_id}，并在完成后从 data.results.items 中读取提及数据。
curl -X POST "https://api.socq.ai/v1/x/mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@OpenAI"],"results_limit":20}'
# 轮询 GET /v1/tasks/{task_id}，解析 data.results.items 中的提及推文。最佳使用场景
- 品牌舆情与公关危机预警： 持续监听官方账号被@提及的推文流，第一时间发现突发公关事件或负面情绪发酵。
- 社交客服工单分流： 捕获向品牌支持账号提出的客户求助、故障反馈或咨询推文，及时介入并转入客服工单。
- 高管与重要人物声量追踪： 监听业内领袖或企业高管账号被提及的内容，评估行业动态或重要产品发布的外部反响。
使用建议
- results_limit 必须为 20 的倍数（如 20、40、100），以对齐上游固定的分页大小限制。
- 日期字符串如 2026-09-01 会由后端自动转换为 UTC 标准时间戳秒数。
- 本接口返回他人提及该账号的推文；若要获取该账号自己发布的帖子，请使用 X User Posts 接口。
- 如需追踪重点提及推文下方的多轮对话展开，可将返回的推文 ID 传入 X Post Replies 接口。
相关 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 User Search API