Twitter User Tweets Scraper API

Twitter User Tweets Scraper

主要特性

• 一次整理多个账号时间线提交一个或多个公开 X 用户名，开头的 @ 可保留也可省略，在同一任务中采集每个账号的近期帖子。
• 聚焦近期发布内容采集过程固定排除回复，使时间线集中呈现账号近期的其他公开发帖活动。
• 每个账号单独计算上限results_limit 分别应用于每个用户名，默认 20，可设置为 20 至 2,000 之间的 20 倍数。
• 适合账号分析的帖子记录每条帖子可包含正文、语言、作者资料、可见互动、媒体、实体、时间和会话关系。
• 保留账号与采集来源extra.input_username 标记提交的账号，collected_at 则记录这次时间线快照的采集时间。

参数

如何使用

先确定要观察的账号，再为它们设置一致的采集深度，即可把近期时间线整理成便于比较的记录。

1. 添加一个或多个公开 X 用户名，开头的 @ 可选。
2. 为每个账号设置 20 至 2,000 之间且为 20 倍数的 results_limit。
3. 向 /v1/x/user-posts POST 请求，并轮询 /v1/tasks/{task_id} 直到任务完成。
4. 逐页追加 data.results.items，在还有后续结果时使用 next_cursor。

curl -X POST "https://api.socq.ai/v1/x/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","OpenAI"],"results_limit":40}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 维护账号观察名单： 通过 extra.input_username 按来源整理近期帖子，持续查看选定品牌、创作者、竞品或公共机构的动态。
• 比较账号发布节奏： 利用 created_at 统计各账号的发帖频率，并观察发布时间、媒体使用和常见主题的变化。
• 建立近期帖子语料库： 将正文、作者、媒体、实体与互动字段组合为带账号归属的数据集，用于分类或内容复盘。

使用建议

• 提交前去掉用户名开头的 @，并忽略大小写进行去重。
• 比较多个账号时使用相同的 results_limit，并确保它是合法的 20 倍数。
• 把 results_limit 视为每个账号的上限，因为实际可返回的近期帖子可能更少。
• 周期采集时先按帖子 id 去重，再把新记录加入已有时间线数据集。
• 用 created_at 分析发布时间顺序，用 collected_at 判断采集快照的新旧。

相关 API