X 公开数据 API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
可用的 X API
根据起始输入选择 API：用户名、帖子 URL、账号列表、搜索词或已知数字 WOEID。
x/profiles
主页每条结果 0.6 积分
x/followers-list
主页每条结果 0.5 积分
x/posts
帖子每条结果 0.5 积分
x/post-retweeters
主页每条结果 0.5 积分
x/user-posts
帖子每条结果 0.5 积分
x/search
搜索每条结果 0.7 积分
x/following-list
主页每条结果 0.5 积分
x/post-quotes
帖子每条结果 0.5 积分
x/post-replies
评论每条结果 0.5 积分
x/trends
搜索每条结果 0.5 积分
x/mentions
帖子每条结果 0.7 积分
x/search-users
搜索每条结果 0.6 积分
x/community
主页每条结果 0.5 积分
x/community-posts
帖子每条结果 0.7 积分
x/thread-context
帖子每条结果 0.5 积分
可以获取哪些 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。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
Pinterest API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。
Threads API
获取公开 Threads 账号、解析指定帖子，或采集选定账号的帖子，并返回标准化身份、内容、媒体、互动和时间字段。
Bluesky API
获取公开 Bluesky 账号、解析指定帖子 URL，或采集一页账号帖子，并返回标准化身份、内容、媒体、时间和可见互动字段。
Snapchat API
将一个已知公开 Snapchat Spotlight 获取为标准化记录，并返回可用的创作者、说明文字、媒体、音频、时间、时长和互动字段。