X 公开数据 API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
可用的 X API
根据起始输入选择 API：用户名、帖子 URL、账号列表、搜索词或已知数字 WOEID。
可以获取哪些 X 数据？
围绕账号身份、指定内容、近期发布活动、帖子发现或按位置划分的当前话题构建数据集。
公开账号资料
将用户名转换为账号身份、简介、视觉素材、账号状态、受众指标、关注者列表、关注列表和采集时间。
指定帖子详情
将公开 status URL 解析为帖子详情、回复、引用帖、转发用户资料、媒体、关系和可见互动。
账号近期帖子
采集选定用户名的近期公开帖子并排除回复，用于比较账号列表中的发布活动。
帖子搜索与发现
使用一个搜索词查找公开帖子，选择 latest 或 top 排序，并为每条结果保留来源搜索词。
按 WOEID 获取当前趋势
采集按位置划分的趋势快照，包含趋势名称、来源排名、查询、描述和观察时间。
SocQ 与 X 开发者产品对比
SocQ 适合一致的公开数据研究流程；X 开发者产品则按其产品与授权要求提供由 X 管理的集成。
| 工作流 | SocQ X 端点 | X 开发者产品 |
|---|---|---|
| 适用任务 | 账号资料完善、帖子研究、监测与公开话题发现 | 由 X 管理的应用与账号集成 |
| 起始输入 | 用户名、status 链接、账号列表、搜索表达式或已知 WOEID | 产品特定请求与授权账号环境 |
| 身份验证 | SocQ API key | X 开发者凭据及适用授权 |
| 数据结构 | 标准化账号、帖子与趋势记录 | 产品特定的 X 原生响应 |
| 处理方式 | 异步任务与结果分页 | 产品特定的请求与响应流程 |
X API 如何工作
十个 X API 都采用相同的提交、跟踪和读取流程。
1. 提交输入
向对应 API 提交用户名、帖子 URL、账号列表、搜索词或数字 WOEID。
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 使用场景
创作者与合作伙伴研究
补充已知用户名、比较公开账号信号，并建立一致的创作者资料。
品牌与市场监测
跟踪选定账号、重复运行固定搜索，或采集已知 WOEID 的趋势，围绕品牌、竞品和话题建立带时间戳的数据集。
营销活动内容报告
解析营销活动帖子 URL，整理内容、作者、媒体、关系和采集时互动。
研究与数据产品
在数据仓库、分类器、搜索索引、审核工具和看板中使用一致的账号与帖子记录。
限制与公开数据政策
SocQ 返回任务运行时公开可访问的 X 数据。
- 账号计数和帖子互动是以 collected_at 为时间锚点的快照。
- 搜索结果按照采集时选择的 latest 或 top 模式排序。
- 趋势排名和描述来自数据源，代表请求 WOEID 在采集时的状态。
- results_limit 设置最大结果数，实际数量取决于任务运行时可获得的公开记录。
- 这些 API 只读取公开数据，不发布帖子或管理 X 账号。
X API 常见问题
X API 可以获取哪些内容？
可以获取公开账号资料、关注者与关注列表、指定帖子、近期帖子、回复、引用帖、转发用户资料、搜索结果，以及已知数字 WOEID 的当前趋势。
应该选择哪个 X API？
账号使用 Profiles、Followers List 或 Following List；status URL 使用 Posts、Post Replies、Post Quotes 或 Post Retweeters；账号近期内容使用 User Posts；搜索发现使用 Search；已知数字 WOEID 使用 Trends。
任务处理流程是什么？
提交 POST 请求，轮询 /v1/tasks/{task_id}，再读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor。
每条结果包含什么？
结果包含对应 API 可获得的字段，例如账号身份、帖子内容与媒体，或趋势名称、来源排名、WOEID、查询、描述和采集时间。
X 指标是实时的吗？
不是。账号计数、帖子互动和趋势排名都是采集快照，比较结果时请使用 collected_at 作为观察时间。
X 数据采集如何计费？
账号资料每条结果 0.6 credits，指定帖子、用户帖子与趋势为 0.5，搜索结果为 0.7。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。