Skip to main content

​
1. Create your account

Sign up at app.social-api.ai. Verify your email and log in.

​
2. Get an API key

In the dashboard, go to Keys → New Key. Give it a name and click Create.
Copy the key immediately - it is shown only once. It starts with sapi_key_.
Store it in your environment: 
export SOCAPI_KEY="sapi_key_your_key_here"

​
3. Connect a social account

In the dashboard, go to Accounts → Connect and choose your platform. Complete the OAuth flow in your browser. Or connect programmatically: 
curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "instagram"}'
The response includes an auth_url. Redirect the user there to complete OAuth.

​
4. List your accounts

curl https://api.social-api.ai/v1/accounts \
  -H "Authorization: Bearer $SOCAPI_KEY"

{
  "data": [
    {
      "id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "platform": "instagram",
      "name": "Acme Corp",
      "username": "acmecorp"
    }
  ],
  "count": 1
}
Copy the id. You’ll use it to scope inbox queries and publish posts.

​
5. Read your inbox

List posts that have comments: 
curl "https://api.social-api.ai/v1/inbox/comments?account_id=acc_01HZ9X3Q4R5M6N7P8V2K0W1J&limit=5" \
  -H "Authorization: Bearer $SOCAPI_KEY"
Then fetch comments on a specific post: 
curl "https://api.social-api.ai/v1/inbox/comments/POST_ID?limit=5" \
  -H "Authorization: Bearer $SOCAPI_KEY"

{
  "data": [
    {
      "id": "sapi_cmt_aW5zdGFncmFtOjE3ODQxNDA1",
      "platform": "instagram",
      "author": {
        "id": "17841405793187218",
        "name": "Jane Smith",
        "avatar_url": "https://example.com/avatar.jpg"
      },
      "text": "Love this product!",
      "created_at": "2026-02-15T14:30:00Z",
      "capabilities": {
        "can_reply": true,
        "can_delete": true,
        "can_hide": true,
        "can_like": true,
        "can_private_reply": true
      }
    }
  ],
  "count": 1
}

​
6. Reply to a comment

curl -X POST \
  "https://api.social-api.ai/v1/inbox/comments/POST_ID" \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Thanks so much, Jane!", "parent_id": "sapi_cmt_aW5zdGFncmFtOjE3ODQxNDA1"}'

{
  "id": "sapi_cmt_cmVwbHk6MTIzNDU2Nzg5",
  "created_at": "2026-02-15T14:35:00Z"
}

​
7. Publish a post

Create a post and publish it to one or more platforms: 
curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world from SocialAPI!",
    "targets": [
      {
        "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
        "platform": "instagram"
      }
    ]
  }'

{
  "id": "post_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "text": "Hello world from SocialAPI!",
  "status": "publishing",
  "targets": [
    {
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "platform": "instagram",
      "status": "publishing"
    }
  ],
  "created_at": "2026-03-15T12:00:00Z"
}
Set scheduled_at to schedule the post for later. Omit it to publish immediately.

​
What’s next

Authentication

API keys, JWTs, and OAuth tokens.

Publishing

Create, schedule, and manage posts.

Pagination

Page through large result sets with cursors.

Platform Support

Capabilities by platform.