You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
SocQ turns public profiles, posts, videos, comments, search results, transcripts, and engagement signals into structured records your applications can use. Authenticate with one API key, submit a collection task, and retrieve normalized results through a consistent REST workflow.
What you can collect
Data type
Available data
Profiles & identity
Public profiles, creator accounts, pages, follower counts, and account metadata
Posts & media
Posts, Reels, videos, Shorts, transcripts, captions, and engagement signals
Comments & feedback
Public comments and available conversation metadata
Search & discovery
Profile, video, keyword, and hashtag discovery, depending on the endpoint
Call a data collection endpoint with your Bearer API key.
Store the returned task_id. New tasks start in the queued state.
Query GET /v1/tasks/{task_id} as the task moves through queued, running, succeeded, or failed.
After success, read normalized records from results.items and continue with results.next_cursor when another page is available.
Add callback_url when you need a completion notification. Callback delivery is best-effort, so polling remains the fallback.
Download compressed raw JSONL data from GET /v1/tasks/{task_id}/files when you need the source records in bulk.
Built for social data workflows
Social listening: Collect public discussions, content, and feedback.
Social analytics: Analyze content, audience, and engagement signals.
Creator intelligence: Research creators, their content, and public performance.
Brand monitoring: Follow brands, competitors, and market activity.
Quickstart
Create an API key, then submit an Instagram profile search:
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "sustainable travel", "results_limit": 25 }'# Save task_id from the submit response, then query the task.
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Successful task responses contain normalized records in data.results.items. Pass data.results.next_cursor back as the cursor query parameter to read the next page.
SocQ is built for public data workflows. It is not an official API of the social platforms represented in its catalog and does not provide access to private account data.
Public examples
SocQAPI/socq-examples is the
canonical directory for all 51 focused API repositories.
Each repository keeps API keys server-side, implements the complete asynchronous
task and pagination flow, and uses synthetic fixtures instead of customer data.