x/
user-replies

输入用户名,按从新到旧采集 X 账号写过的回复,每条回复都附带它所回应的帖子,被回复帖子的正文、作者、链接和发布时间就在同一行里。

X User Replies API

用户名输入
账号本人写的回复
附带被回复的帖子
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

X User Replies

X(Twitter)个人主页的“回复”标签页收录了账号回复别人推文的内容,按从新到旧排列,每条回复都属于某个会话,并指向它所回应的帖子及其作者和正文。把回复和被回复的帖子对照着看,就能知道一个账号在和谁对话、在主时间线之外说了什么,以及它如何回应提问和批评。

X User Replies API 主要特性

  • 某个账号亲自写的回复提交一个用户名,开头的 @ 可带可不带,即可拿到该账号发出的回复,内容来自它的“回复”标签页,最新的在前。
  • 被回复的帖子就在同一行in_reply_to 包含每条回复所回应帖子的 id、url、text、author 和 published_at,每一段对话直接从结果里就能读完整。
  • 会话 ID 与上级帖子 IDconversation_id 和 in_reply_to_id 把每条回复关联到所在的会话和它正上方的那条帖子,方便按会话归组。
  • 回复正文、媒体与互动每条回复都带有正文、所附的图片或视频,以及点赞、评论、转发和浏览数。

X User Replies API 参数

参数必填描述
username必填要采集回复的 X 用户名,开头的 @ 可带可不带。
results_limit可选返回的回复数量,取值 1 到 1,000,默认 20。

如何使用 X User Replies API

提交一个用户名,连同被回复的帖子一起读取它的回复。

  1. 向 /v1/x/user-replies 发送 {"username": "elonmusk", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 从 results.items 读取回复,被回复的帖子在 in_reply_to 中;has_more 为 true 时,传入 results.next_cursor 继续读取。
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}'

# in_reply_to 是每条回复所回应的帖子,包含正文、作者、链接和发布时间。

X User Replies API 最佳使用场景

  • 梳理账号在和谁对话: 统计账号所有回复里的 in_reply_to.author.username,列出它最常互动的人和品牌。
  • 检查品牌客服的回复质量: 把每条回复的 text 和 in_reply_to.text 对照阅读,再用 published_at 减去 in_reply_to.published_at,衡量客服账号回复得多快、答得好不好。
  • 跟踪公众人物在回复里的发言: 定期采集高管或政治人物的回复,捕捉他们在对话中给出的表态,并保留 url 作为出处。
  • 构建帖子与回复的配对数据: 把 in_reply_to.text 和 text 配成一对,组成对话数据集,用来研究账号回应时的语气、立场或话题。

X User Replies API 使用建议

  • 做情感或长度分析前,先去掉 text 开头的 @账号名,因为回复会以被回复账号的 @ 开头。
  • 按 conversation_id 归组,就能看到账号在同一个会话里留下的全部回复。
  • in_reply_to.text 或其作者为空时,照样保留这条回复,并存下 in_reply_to.url,之后可以再去查那条帖子。
  • 需要看别人在该账号帖子下回复了什么时,用 X Post Replies API 提交帖子链接;X User Replies API 负责账号自己写的回复。

除了 X User 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 Post Replies API — 从 X 帖子 URL 采集公开回复,支持选择排序,并返回回复正文、作者、可见互动、媒体和父帖信息。
  • X Thread Context API — 读取帖子及其回复链上的公开前文、后续回复和关系标识。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

X User Replies API — 常见问题

X User Replies API 是一个用于根据用户名采集 X 账号所写回复的 API,数据来自该账号的“回复”标签页。它返回每条回复的正文、互动数据、媒体和会话 ID,并在 in_reply_to 中附上它所回应的帖子。

提交对方的用户名,把 results_limit 设成想要的回复数量。回复按从新到旧返回,has_more 为 true 时用 next_cursor 继续读取。

X User Replies API 返回某一个账号写下的回复,不论回在哪条帖子下。X Post Replies API 返回其他人在你提交的帖子链接下留下的回复。

是的。in_reply_to 给出那条帖子的 id、url 和发布时间,帖子公开可见时还会带上它的正文和作者。

单个用户名可返回 1 到 1,000 条,默认 20 条。要覆盖多个账号,每个用户名单独提交一次请求。