SocQ Documentation
SocQ provides asynchronous APIs for public data across Instagram, Facebook, YouTube, TikTok, X, LinkedIn, Reddit, Pinterest, Threads, and commerce or ad-research products.Base URL
Authentication
All requests require an API key:Request Flow
1
Submit a data task
Call one of the product endpoints, such as
POST /v1/instagram/posts.2
Receive a task ID
The submit endpoint returns immediately with a
task_id.3
Query task status
Poll
GET /v1/tasks/{task_id} until the status becomes succeeded or failed.4
Read results
When the task succeeds,
GET /v1/tasks/{task_id} automatically returns normalized records under results. Download raw JSONL files from GET /v1/tasks/{task_id}/files.Status Values
Data collection tasks are asynchronous. A successful submit response means the task was created, not that the final data is ready.