API
该 API 为社交数据采集提供一致的请求流程：验证
提交端点
每个产品API都有自己的资源路径：通用提交正文
输入字段直接在 JSON 正文中发送。callback_url 是可选的。如果提供，SocQ 在任务达到最终状态后发送 POST 请求。有关有效负载形状，请参阅回调。
直接 REST 提交默认为 request_source="rest"。 Agent Skill 使用 REST 作为回退发送 X-Socq-Source: skill-rest；该值由任务详细信息端点返回以进行归因。
通过 MCP 或 CLI 使用相同的端点
每个 REST 采集端点都有一个稳定的端点 ID、键入的 MCP 工具和 CLI 命令。 JSON 请求字段保持不变：结果存储
SocQ 存储两种形式的结果：
原始文件使用以下路径格式：
计费
代理API按照返回结果记录计费。提交请求可能会从results_limit 或提交的 URL/用户名数量中保留积分；任务完成后，SocQ 从实际的 result_count 中结算最终费用，并返回任何未使用的预留积分。评论端点不接受results_limit，并根据实际返回的评论数进行计费。
每个功能条目都会公开其当前的计费单位和积分价格。大采集之前，先检查一下能力条目，并使用适合您界面的账户工具：
- MCP：
socq_account - CLI：
socq account
402 响应表示账户积分不足。 API 密钥积分和请求限额与账户余额无关；请参阅身份验证 和错误。