SOCIAL MEDIA DATA API
One API for Instagram, TikTok, YouTube, X and Facebook.
Use one workspace API key to collect profiles, posts, comments, followers, search results, transcripts and ad research across five social platforms. The same job, batch, schedule and saved-result model works throughout the catalog.
ONE CONTRACT
The execution model stays familiar across all five platforms.
Platform-specific inputs remain explicit, while authentication, estimates, progress, cancellation, result paging and exports follow one Caelario contract.
Live capability discovery
Read exact targets, limits and current billing before constructing a request.
Immediate extraction
Use POST /v1/extract for one bounded target when the result can return inside the request.
Durable jobs and batches
Use jobs for larger work and batches for lists whose targets must retry or fail independently.
Schedules and saved results
Repeat collections and retrieve completed datasets without paying again to inspect them.
ONE EXTRACTION REQUEST
The payload names the platform, operation and target.
The same structure is used by the dashboard and MCP package, so tested requests transfer cleanly into your application.
cURL
curl -X POST https://api.caelario.com/v1/extract \
-H "X-API-Key: $CAELARIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "instagram",
"operation": "profile",
"target": "nike",
"limit": 1
}'REQUEST, JOB OR BATCH
Choose execution by workload, not by platform.
A single bounded request can answer now; a larger collection can survive a closed connection; a batch keeps each target independent under one parent identifier.
- 01Create a workspace keyGenerate a scoped API key from the Caelario dashboard.
- 02Inspect the catalogChoose the platform and operation, then confirm its required target and limit.
- 03Run and retrieveCall the immediate endpoint or create durable work and page through the saved result.
BUILD WITH THE DATA
Use the same infrastructure for one lookup and recurring collections.
Product integrationsAgency data pipelinesCross-platform monitoringResearch automation
QUESTIONS
Social media API questions.
Which platforms are supported?
Instagram, TikTok, YouTube, X and Facebook are supported in the current catalog.
Is every operation priced the same?
No. The capability guide returns the current billing model for each operation. Estimates reserve a maximum; final charges follow delivered results or the stated collection price.
Do I have to create jobs for every request?
No. One bounded target can use the immediate extraction endpoint. Larger or multi-target work should use durable jobs and batches.
Can I use the same API key with MCP?
Yes. The Caelario MCP package uses a workspace API key and the same API, balance, jobs, schedules and saved results.