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
提交一个用户名,连同被回复的帖子一起读取它的回复。
- 向 /v1/x/user-replies 发送 {"username": "elonmusk", "results_limit": 20}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 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 负责账号自己写的回复。
相关 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 Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- Twitter Follow Checker API
- Twitter Video Transcript API