API Overview
MisarSocial REST API reference — base URL, authentication, versioning, and rate limits.
Base URL
https://api.misar.io/socialAll endpoints listed in this reference are relative to this base URL.
Authentication
MisarSocial supports two authentication methods:
Session cookie (browser)
Requests from the browser use the Supabase session cookie set by social.misar.io. No extra setup needed.
API key (server-to-server)
Generate an API key from Dashboard → Settings → API Keys and pass it as a Bearer token:
Authorization: Bearer mss_your_key_hereAPI keys are scoped. Create separate keys for read-only integrations vs. write integrations to follow the principle of least privilege.
Available Scopes
| Scope | Description |
|---|---|
posts:read | List and read posts |
posts:write | Create, edit, and cancel posts |
schedule:write | Schedule posts to the queue |
drafts:read | Read draft post variants |
drafts:write | Approve or reject drafts |
generate:write | Trigger AI content generation |
stats:read | Read dashboard and engagement stats |
connections:read | List connected social accounts |
trendpulse:read | Read trend snapshots |
contentripple:write | Submit content for repurposing |
Rate Limits
Rate limit headers are returned on every response:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests in the window |
X-RateLimit-Remaining | Remaining requests in the current window |
When a rate limit is exceeded the API returns 429 Too Many Requests.
Common Response Formats
Success
{ "posts": [...], "total": 42, "page": 1, "pageSize": 20, "totalPages": 3 }Error
{ "error": "Human-readable error message" }Endpoints
| Endpoint | Methods | Description |
|---|---|---|
/api/posts | GET DELETE | List or cancel posts |
/api/posts/:id | PATCH DELETE | Edit or cancel a single post |
/api/drafts | GET POST | List drafts, bulk approve/reject |
/api/schedule | POST | Schedule a post |
/api/connections | GET | List connected accounts |
/api/generate | POST | AI post generation |
/api/generate/enhance | POST | Enhance existing text |
/api/generate/hashtags | POST | Generate hashtags for text |
/api/generate/optimize | POST | Platform-optimize existing text |
/api/stats | GET | Dashboard overview stats |
/api/trendpulse | GET POST | Trend snapshots and pipeline |
/api/contentripple | GET POST | Content repurposing |
/api/calendar | GET | Calendar view of scheduled posts |