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

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