MisarBlog REST API — publish articles, manage content, and integrate AI tools programmatically.

MisarBlog API

The MisarBlog REST API lets you publish articles, manage drafts, generate AI images, pull analytics, and build AI-powered writing tools — all from your own code.

Base URL: https://api.misar.io/blog/v1

Quick Start

curl https://api.misar.io/blog/v1/me \
  -H "Authorization: Bearer mbk_YOUR_KEY"

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer mbk_YOUR_API_KEY

Get your API key from Dashboard → Settings → API Keys. Keys start with mbk_.

Endpoints

Profile

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /me | Get your creator profile |

Articles

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /articles | List your articles | | POST | /articles | Publish or schedule an article | | GET | /articles/{slug} | Get a single article |

Drafts

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /drafts | Save an article as a draft |

Series

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /series | List your series | | POST | /series | Create a series | | POST | /series/{slug}/articles | Add an article to a series |

Images

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /images/upload | Upload an image to CDN | | POST | /images/generate | Generate a cover image with AI |

Analytics

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /analytics | Get views, revenue, and subscriber stats |

AI

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /ai/titles | Generate title suggestions | | POST | /ai/research | Stream AI-powered research (SSE) |

API Keys

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /keys | Create an API key | | DELETE | /keys | Revoke your API key |

Response Format

All responses return JSON.

Success:

{ "id": "...", "slug": "...", "title": "..." }

Error:

{ "error": "Human-readable message" }

Rate Limits

| Plan | Requests/min | |------|-------------| | Free | 60 | | Pro | 300 | | Business | 1 000 |

Headers returned on every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1712345678

When exceeded: 429 Too Many Requests

OpenAPI Spec

Machine-readable spec available at:

GET https://api.misar.io/blog/v1/openapi.json

API Overview