Step 01
Get your API key
Generate a key in the ContentStudio dashboard and store it as an environment variable. Keys are prefixed cs_ so they are easy to spot in a log.
Settings → API KeysSocial Media API
Social media API for developers and automation builders
Run social media across all major platforms with our social media API. Built for developers, automation builders, and agency tech leads to publish, schedule, analyze, and manage your inbox, from your own app or AI agent.
- REST
- https://api.contentstudio.io/api/v1
- AUTH
- X-API-Key: cs_your_api_key
- MCP
- https://mcp.contentstudio.io/v1/mcp
Integrated with
AI
AI
AI
AI
AI
AI
AI
AI
Trusted by 16,500+ leading brands and agencies
How it works
Your first API call in under 5 minutes
Make your first API call in minutes and unlock publishing, analytics, approvals, inbox, automation, and AI media across all major networks.
Step 02
Find your workspace
Every resource lives under a workspace. This returns the workspace_id that goes in almost every other path. It confirms the key works at the same time.
GET /api/v1/workspacesStep 03
List your accounts
Returns the connected profiles and their account IDs. You need these before you can target a post. The platform is detected automatically from the ID.
GET /api/v1/workspaces/{workspace_id}/accountsStep 04
Create posts
Send content, account IDs, and a scheduling block. The response returns a post ID; use it to update, delete, approve, or comment on that post later.
POST /api/v1/workspaces/{workspace_id}/postsOne social media API to automate everything
A social media API with everything you need to automate at scale: publishing, analytics, approvals, inbox and AI media.
Publishing & scheduling
Create, schedule and publish posts across every connected network from a single call, with full control over the timing.
AI image & video generation
Generate on-brand AI images and videos from a simple prompt, with your brand colours, fonts and assets applied before you ever see it.
Analytics
Pull performance data for every connected account, with plain AI insights explaining what moved and why it did so.
Unified inbox
Read and reply to comments, messages and reviews from every connected network in one feed, without switching between tabs.
Approvals & governance
Route content through whatever review steps your own team needs, and control who can approve or publish to which accounts.
Competitor benchmarking
Track competitor accounts and compare their growth, posting habits, and engagement against your own numbers, side by side.
Content automation
Keep the calendar full on its own, from a feed, a loop of recycled content, or a single bulk upload of hundreds of posts.
Client share links
Send content out for review through a link that needs no login at all, then see exactly what got approved and by whom too.
Content library, teams & reports
Store all your media, manage who on the team can access what, schedule recurring reports, and track usage from one place.
Built for AI agents
Prefer to work through an AI assistant?
Hosted MCP server
One URL, nothing to download. Works in Claude, ChatGPT, Cursor, Grok, Claude Code, and Codex.
https://mcp.contentstudio.io/v1/mcp
CLI & agent skills
For Claude Code and OpenClaw agents that drive a real command-line tool. Open source, MIT-0, so you can audit every line.
npm install -g contentstudio-cli contentstudio auth:login --api-key cs_...
REST or MCP?
Use REST when your own code decides what to post. Use MCP when a model decides. Both run on the same key and a dry-run preview.
Supports every network you already use
Reels, Stories, carousels, threads, polls, and Shorts, plus the fields each network demands when you use them.
- FacebookAnalyticsYes
- Feed
- Reel
- Story
- Carousel
- Video
- Poll
Carousel cards, Page collaborators, text backgrounds
- InstagramAnalyticsYes
- Feed
- Carousel
- Reel
- Story
Collaborators, trial Reels
- X (Twitter)AnalyticsYes
- Feed
- Thread
Threaded tweets
- LinkedInAnalyticsYes
- Feed
- Document carousel
- Video
- Poll
Poll object, custom title
- TikTokAnalyticsYes
- Video
- Photo post
Privacy level, duet/stitch/comment toggles, 3 disclosure flags
- PinterestAnalyticsYes
- Image
- Video
- Carousel pin
Board, destination link, pin title
- YouTubeAnalyticsYes
- Video
- Shorts
Privacy status, category, tags, made-for-kids, license
- ThreadsAnalyticsYes
- Feed
- Multi-post thread
Chained Threads posts
- BlueskyAnalyticsYes
- Feed
- TelegramAnalyticsNo
- Feed
- TumblrAnalyticsNo
- Feed
- Google Business ProfileAnalyticsYes
- Update
- Event
- Offer
- CTA post
Topic type, start/end date, CTA link
Integrations
Scale with your favorite automation tools
Build connected social workflows to create posts, manage content, and pass data between your tools, so you can focus on growth while routine steps run without manual effort.
Build detailed posting workflows that pull content from multiple sources and schedule across channels.
Connect with Make
Create custom automations that handle posting, content sync, and multi-platform scheduling.
Connect with n8n
Connect ContentStudio with 2,000+ apps to automate scheduling, sync lead data, and trigger posts
Connect with Pabbly
Built around real use cases
Embed a scheduler your users never leave. Run forty client accounts from one dashboard. Fill next month's calendar from an RSS feed. Let an agent draft and publish on its own. Four problems, the same endpoints, one key.
Developers & SaaS
Automate publishing and scheduling
Create posts, set times, and publish across every channel directly from your own systems, without building platform integrations yourself.
Product teams
Build custom content dashboards
Filter posts, view drafts and approvals, and pull analytics into your own interface using the same endpoints the ContentStudio app runs on.
Agencies
Create client portals
Let clients review drafts, approve content, and check schedules through share links, then read the activity log back into your own reporting.
AI builders
Power AI agents and inbox tools
Let an agent publish on its own, or manage comments, conversations, and reviews from your support tooling through the inbox endpoints.
Social media API built for developers and automation builders
Schedule, publish, and manage content programmatically from any workflow. Set up in minutes, no complex configuration required.
What's Included
1 Workspace & 1 User
15 GB Media Storage
Dedicated API Dashboard
Zapier, Make, n8n, Pabbly
Other Features
API key management & activity logs
Usage alerts at 80% & 90%
Content Library
Publisher module
Flexible API request add-ons
Secure API key management
Supported Integrations
$15/month
$180 billed annually
Save $48/yrSocial Accounts
1050
API Requests
3,000
3,00050,000
No credit card required • 7-day free trial • Cancel anytime
Schedule posts instantly with a short code snippet
Explore our API endpoints with code examples in multiple languages
TypeScript
POST
/api/v1/workspaces/{workspace_id}/postsCreate and schedule a post across one or more social accounts. Supports draft, scheduled, and queued publishing.
Request
curl -X POST \ "https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/posts" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": { "text": "Check out our latest product launch!", "media": { "images": ["https://example.com/image.jpg"] } }, "accounts": [ "350830594784444", "17841453340834745" ], "post_type": "feed", "scheduling": { "publish_type": "scheduled", "scheduled_at": "2024-12-25 15:30:00" }, "first_comment": { "message": "More details in the thread!", "accounts": ["350830594784444"] } }'
Response
{ "status": true, "message": "Post created successfully", "data": { "id": "61e006a89be9dd0cd07ec692", "workspace_id": "610a1e660cb41530ca40d372", "content": { "text": "Check out our latest product launch!" }, "scheduling": { "status": "scheduled", "scheduled_at": "2024-12-25T15:30:00Z", "timezone": "America/New_York" }, "created_at": "2024-01-15T10:30:00Z" } }
Base URL:
https://api.contentstudio.ioAuth: X-API-Key: YOUR_API_KEYThe post id returned can be used to update, delete, or approve the post.4.2MPost ScheduledIncrease in productivity with ContentStudio
50%Productivity BoostIncrease in productivity with ContentStudio
$1,000+Cost Savingssaved monthly on social media management costs
5h/weekTime Savedsaved on content planning and scheduling
The perfect tool for agency-client collaboration and content approvals.
What our customers say
FAQs
FAQ
What is a social media API?
A social media API is a set of endpoints that lets your app talk to platforms like Facebook, LinkedIn, or X. It allows you to publish posts, fetch data, and manage accounts programmatically instead of using the UI. ContentStudio's social media API brings all of that into one unified integration.
Who is the social media API plan built for?
The social media API plan is for developers, automation builders, and agency tech leads who need a clean publishing endpoint via REST API. It gives you publishing without the overhead of the full social media management suite. You get exactly the integration you need and nothing you do not.
Which social networks can I publish to via the API?
The API supports all major networks in ContentStudio, including Facebook, Instagram, LinkedIn, X (Twitter), TikTok, YouTube, Pinterest, Threads, Bluesky, Google Business Profile, and Telegram. X (Twitter) posting is capped at 30 posts per day by default, with more capacity available as a paid add-on. That is 11 networks from one integration.
How do I generate and manage my API key?
Once you complete onboarding, you land directly on your API Dashboard, where you click Generate API Key to create your key and secret. You can revoke or regenerate your key any time from the same screen. Your secret is shown only once at generation, so copy it immediately and store it securely.
What are the rate limits on the API plan?
The API plan includes 3,000 API requests per month by default, and your dashboard shows real-time rate limit status. You receive an in-app alert at 80 percent usage and an email at 90 percent. If you need more, you can add 1,000 requests at any time from your billing page.
What happens when I hit my API request limit?
You receive an in-app alert at 80 percent usage and an email at 90 percent, and your dashboard shows live usage at all times. If you need more capacity, you can add extra requests instantly from the billing page. There is no upper cap on add-ons.
Can I pull analytics through the API?
Yes, the API gives you analytics for Facebook, Instagram, and YouTube. You can fetch reach, engagement, and audience metrics and pull them straight into your own dashboards or reports. That lets your app show performance data without any manual exports.
Does the API plan work with Zapier, Make, n8n, and Pabbly?
Yes, all four are supported out of the box using your API credentials. If your automation platform supports REST API calls through an HTTP module, it will work with ContentStudio's API too. Integration guides and sample workflow templates are available in the API Dashboard under Quick Links.
Can I use the API to build an AI agent?
Yes, the social media API is built to power AI agents and apps. Your agent can connect accounts, generate content, schedule, and publish across every network on its own. Build a publishing agent on Claude or any AI tool without wiring up each platform by hand.
How long is the free trial, and what is included?
The API plan trial is 7-days with no credit card required, and you get full access to everything in the plan. That includes the API Dashboard, key generation, publishing, content library, and all integrations. At the end of the trial, your account pauses, with no automatic charges.
