Skip to main content

​
SocQ Documentation

SocQ provides asynchronous social data APIs for public Instagram and Facebook data.

​
Base URL

https://api.socq.ai

​
Authentication

All requests require an API key: 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
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

StatusDescription
queuedTask has been accepted and is waiting to run
runningTask is processing
succeededTask completed successfully
failedTask failed; see error_message
Data collection tasks are asynchronous. A successful submit response means the task was created, not that the final data is ready.