Getting Started with ContentStudio API

Welcome to the ContentStudio API! This comprehensive REST API allows you to manage social media content, workspaces, and accounts programmatically.

What is ContentStudio?

ContentStudio is a powerful social media management platform that helps businesses and creators plan, create, and publish content across multiple social media platforms including Facebook, Instagram, Twitter, LinkedIn, Pinterest, YouTube, TikTok, and more.

API Overview

The ContentStudio API v1 provides:

Social Media Management: Create, schedule, and publish posts across multiple platforms
Workspace Listing: List all workspaces associated with your account
Account Listing: List all social media accounts associated with your account

🚀 Ready to get started?

Follow our quick start guide to make your first API call in minutes!

Authentication

All API requests require authentication using your API key in the X-API-Key header.

Getting Your API Key

1Log in to your ContentStudio dashboard

2Navigate to Settings → API Keys

3Generate a new API key

4Copy and securely store your API key

Using Your API Key

Include your API key in the X-API-Key header with every request:

curl -H "X-API-Key: cs_your_api_key_here" \
                    https://api.contentstudio.io/api/v1/me

🔒 Security Best Practices

Never expose your API key in client-side code or public repositories. Store it securely as an environment variable.

Quick Start Guide

Get up and running with the ContentStudio API in 5 minutes!

Step 1: Test Your Connection

Verify your API key works by calling the /me endpoint:

GET /api/v1/me

Step 2: Get Your Workspaces

Retrieve your available workspaces:

GET /api/v1/workspaces

Step 3: List Social Accounts

Get social media accounts for a workspace:

GET /api/v1/workspaces/{workspace_id}/accounts

Step 4: Create Your First Post

Create and publish a social media post:

POST /api/v1/workspaces/{workspace_id}/posts
Content-Type: application/json

{
  "content": {
    "text": "Hello from ContentStudio API!",
    "media": {
      "images": ["https://example.com/image.jpg"]
    }
  },
  "accounts": ["account_id_1", "account_id_2"],
  "scheduling": {
    "publish_type": "now"
  }
}

🎉 Congratulations!

You've successfully created your first post using the ContentStudio API!

Error Handling

The API uses conventional HTTP response codes and returns detailed error information in JSON format.

HTTP Status Codes

200 - Success
400 - Bad request / Validation error
401 - Unauthorized / Invalid API key
403 - Forbidden / Insufficient permissions
404 - Resource not found
429 - Rate limit exceeded
500 - Internal server error

Error Response Format

                        
                            {
                                "status": false,
                                "message": "Error description",
                            }