API Reference

https://api.studio.ei.au/v1

Authorization: Bearer YOUR_API_KEY

POST /content/generate

{
  "prompt": "string", // Required: Content generation prompt
  "platforms": ["instagram", "tiktok"], // Required: Target platforms
  "settings": {
    "creativity": 5, // 1-10, default: 5
    "tone": "professional", // professional, casual, friendly, etc.
    "length": "medium", // short, medium, long
    "includeHashtags": true,
    "hashtagCount": 10,
    "includeEmojis": true,
    "brandId": "brnd_123", // Optional: Apply brand guidelines
    "language": "en" // ISO 639-1 code
  },
  "media": {
    "generate": true, // Generate AI images
    "style": "photorealistic", // photorealistic, illustration, etc.
    "count": 3 // Number of images to generate
  }
}

{
  "id": "cnt_abc123",
  "status": "generated",
  "createdAt": "2024-01-15T10:00:00Z",
  "content": {
    "instagram": {
      "caption": "Generated caption text...",
      "hashtags": ["#hashtag1", "#hashtag2"],
      "firstComment": "Optional first comment",
      "altText": "Image description"
    },
    "tiktok": {
      "caption": "TikTok optimized caption...",
      "hashtags": ["#trending", "#fyp"],
      "sounds": ["sound_id_123"]
    }
  },
  "media": [
    {
      "id": "med_123",
      "type": "image",
      "url": "https://cdn.studio.ei.au/...",
      "thumbnailUrl": "https://cdn.studio.ei.au/...",
      "dimensions": {
        "width": 1080,
        "height": 1080
      }
    }
  ]
}

GET /content

{
  "data": [
    {
      "id": "cnt_123",
      "status": "scheduled",
      "platforms": ["instagram"],
      "createdAt": "2024-01-15T10:00:00Z",
      "scheduledFor": "2024-01-16T14:00:00Z",
      "content": {...}
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 145,
    "pages": 8
  }
}

GET /content/{contentId}

{
  "id": "cnt_123",
  "status": "published",
  "platforms": ["instagram", "facebook"],
  "createdAt": "2024-01-15T10:00:00Z",
  "publishedAt": "2024-01-15T14:00:00Z",
  "content": {
    "instagram": {...},
    "facebook": {...}
  },
  "media": [...],
  "analytics": {
    "views": 1250,
    "likes": 89,
    "comments": 12,
    "shares": 5
  }
}

PUT /content/{contentId}

{
  "content": {
    "instagram": {
      "caption": "Updated caption text..."
    }
  },
  "status": "draft"
}

DELETE /content/{contentId}

POST /content/{contentId}/schedule

{
  "scheduledFor": "2024-01-20T14:00:00Z",
  "profiles": ["prf_123", "prf_456"],
  "options": {
    "crossPost": true,
    "firstComment": "Check link in bio",
    "timezone": "America/New_York"
  }
}

POST /content/{contentId}/publish

{
  "profiles": ["prf_123", "prf_456"],
  "options": {
    "crossPost": true,
    "notifyFollowers": true
  }
}

GET /profiles

{
  "data": [
    {
      "id": "prf_123",
      "platform": "instagram",
      "username": "@yourbrand",
      "displayName": "Your Brand",
      "connected": true,
      "connectedAt": "2024-01-01T10:00:00Z",
      "followerCount": 10500,
      "profilePicture": "https://...",
      "settings": {
        "autoHashtags": ["#brand"],
        "defaultVisibility": "public"
      }
    }
  ]
}

POST /profiles/connect

{
  "platform": "instagram",
  "redirectUri": "https://yourapp.com/callback"
}

{
  "authUrl": "https://api.instagram.com/oauth/authorize?...",
  "state": "state_token_123"
}

DELETE /profiles/{profileId}

PUT /profiles/{profileId}/settings

{
  "displayName": "Updated Name",
  "settings": {
    "autoHashtags": ["#newtag"],
    "postingTimes": ["09:00", "14:00", "19:00"],
    "timezone": "America/New_York"
  }
}

GET /brands

POST /brands

{
  "name": "Brand Name",
  "description": "Brand description",
  "guidelines": {
    "voice": "professional",
    "tone": ["friendly", "informative"],
    "colors": {
      "primary": "#FF6B6B",
      "secondary": "#4ECDC4"
    },
    "hashtags": ["#brand", "#official"]
  },
  "assets": {
    "logo": "https://...",
    "fonts": ["Helvetica", "Arial"]
  }
}

PUT /brands/{brandId}

DELETE /brands/{brandId}

POST /brands/{brandId}/assets

{
  "assetId": "ast_123",
  "type": "image",
  "url": "https://cdn.studio.ei.au/...",
  "metadata": {
    "filename": "logo.png",
    "size": 45678,
    "dimensions": {
      "width": 500,
      "height": 500
    }
  }
}

GET /analytics/content

{
  "period": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  },
  "metrics": {
    "totalPosts": 45,
    "totalReach": 125000,
    "totalEngagement": 8900,
    "avgEngagementRate": 3.4
  },
  "breakdown": [
    {
      "date": "2024-01-15",
      "posts": 2,
      "reach": 5600,
      "engagement": 234
    }
  ]
}

GET /analytics/profiles/{profileId}

{
  "profile": {
    "id": "prf_123",
    "platform": "instagram",
    "username": "@yourbrand"
  },
  "metrics": {
    "followers": 10500,
    "followersGrowth": 2.3,
    "avgEngagement": 4.5,
    "postsPerWeek": 5.2
  },
  "topContent": [
    {
      "id": "cnt_789",
      "engagement": 1250,
      "type": "reel"
    }
  ]
}

POST /webhooks

{
  "url": "https://yourapp.com/webhooks",
  "events": ["content.published", "content.failed"],
  "secret": "webhook_secret_key",
  "active": true
}

GET /webhooks

PUT /webhooks/{webhookId}

DELETE /webhooks/{webhookId}

POST /webhooks/{webhookId}/test

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message",
    "details": {
      // Additional error context
    }
  },
  "requestId": "req_abc123"
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1641024000
X-RateLimit-Retry-After: 60

GET /content?status=scheduled&platform=instagram&startDate=2024-01-01

GET /content?sortBy=createdAt&sortOrder=desc

GET /content?fields=id,status,createdAt

POST /content/batch
{
  "operations": [
    {
      "method": "update",
      "id": "cnt_123",
      "data": {...}
    },
    {
      "method": "delete",
      "id": "cnt_456"
    }
  ]
}

https://api.studio.ei.au/v2