Skip to main content

SocQ 文档

SocQ 提供跨 Instagram、Facebook、YouTube、TikTok、X、LinkedIn、Reddit、Pinterest、 Threads,以及商业或广告研究产品。

基础 URL

验证

所有请求都需要 API 密钥:

请求流程

1

提交数据任务

调用产品端点之一,例如 POST /v1/instagram/posts
2

接收任务 ID

提交端点立即返回 task_id
3

查询任务状态

轮询 GET /v1/tasks/{task_id},直到状态变为 succeededfailed
4

读取结果

当任务成功时,GET /v1/tasks/{task_id} 会自动返回 results 下的规范化记录。从 GET /v1/tasks/{task_id}/files 下载原始 JSONL 文件。

状态值

数据采集任务是异步的。成功提交响应意味着任务已创建,而不是最终数据已准备好。

Agent 集成

当 AI 工作流需要发现和调用 SocQ API 时,请使用托管 MCP 服务器、npm CLI 或 Agent Skill。从集成概述 开始。