X 公开数据 API
通过用户名、帖子 URL、账号列表或搜索词获取公开 X 账号与帖子数据，用于创作者研究、品牌监测和内容分析。
可用的 X API
根据起始输入选择 API：用户名、帖子 URL、账号列表或搜索词。
可以获取哪些 X 数据？
围绕账号身份、指定内容、近期发布活动或话题发现构建数据集。
公开账号资料
将用户名转换为账号身份、简介、视觉素材、账号状态、受众指标和采集时间。
指定帖子详情
将公开 x.com 或 twitter.com 帖子 URL 解析为正文、作者、媒体、实体、关系和可见互动。
账号近期帖子
采集选定用户名的近期公开帖子并排除回复，用于比较账号列表中的发布活动。
帖子搜索与发现
使用一个搜索词查找公开帖子，选择 latest 或 top 排序，并为每条结果保留来源搜索词。
SocQ 与 X 开发者产品对比
SocQ 适合一致的公开数据研究流程；X 开发者产品则按其产品与授权要求提供由 X 管理的集成。
| 工作流 | SocQ X 端点 | X 开发者产品 |
|---|---|---|
| 适用任务 | 账号资料完善、帖子研究、监测与发现 | 由 X 管理的应用与账号集成 |
| 起始输入 | 用户名、status 链接、账号列表或一个搜索表达式 | 产品特定请求与授权账号环境 |
| 身份验证 | SocQ API key | X 开发者凭据及适用授权 |
| 数据结构 | 标准化账号资料与帖子记录 | 产品特定的 X 原生响应 |
| 处理方式 | 异步任务与结果分页 | 产品特定的请求与响应流程 |
X API 如何工作
四个 X API 都采用相同的提交、跟踪和读取流程。
1. 提交输入
向对应 API 提交用户名、帖子 URL、账号列表或一个搜索词。
2. 跟踪任务
使用 task_id 请求 /v1/tasks/{task_id}，直到任务处理完成。
3. 获取结果
读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权并提交一个或多个 X 用户名。帖子、用户帖子和搜索 API 使用相同的任务流程。
curl -X POST "https://api.socq.ai/v1/x/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@OpenAI"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor常见 X API 使用场景
创作者与合作伙伴研究
补充已知用户名、比较公开账号信号，并建立一致的创作者资料。
品牌与市场监测
跟踪选定账号或重复运行固定搜索，围绕品牌、竞品和话题建立带时间戳的数据集。
营销活动内容报告
解析营销活动帖子 URL，整理内容、作者、媒体、关系和采集时互动。
研究与数据产品
在数据仓库、分类器、搜索索引、审核工具和看板中使用一致的账号与帖子记录。
限制与公开数据政策
SocQ 返回任务运行时公开可访问的 X 数据。
- 账号计数和帖子互动是以 collected_at 为时间锚点的快照。
- 搜索结果按照采集时选择的 latest 或 top 模式排序。
- results_limit 设置最大结果数，实际数量取决于任务运行时可获得的公开记录。
- 这些 API 只读取公开数据，不发布帖子或管理 X 账号。
X API 常见问题
X API 可以获取哪些内容？
可以获取公开账号资料、解析指定帖子、采集选定账号的近期帖子，并通过一个搜索词发现公开帖子。
应该选择哪个 X API？
用户名使用 Profiles，帖子 URL 使用 Posts，账号列表使用 User Posts，按搜索词发现内容使用 Search。
任务处理流程是什么？
提交 POST 请求，轮询 /v1/tasks/{task_id}，再读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor。
每条结果包含什么？
结果包含对应 API 可获得的账号或帖子字段，例如身份、内容、媒体、实体、关系、可见指标和采集时间。
X 指标是实时的吗？
不是。账号计数和帖子互动是采集快照，比较结果时请使用 collected_at 作为观察时间。
X 数据采集如何计费？
账号资料每条结果 0.6 credits，指定帖子与用户帖子为 0.5，搜索结果为 0.7。