API Overview
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_KEYGet 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 |
| PATCH | /articles/{slug} | Update or publish a draft |
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 |
Search & Recommendations
| Method | Endpoint | Description |
|---|---|---|
| GET | /search | Search articles, profiles, and tags |
| GET | /recommendations | Semantically similar public articles |
Reactions
| Method | Endpoint | Description |
|---|---|---|
| GET | /reactions | Reaction counts + your own reactions |
| POST | /reactions | Add or toggle a reaction |
| DELETE | /reactions | Remove a reaction |
AI
| Method | Endpoint | Description |
|---|---|---|
| POST | /ai/titles | Generate title suggestions |
| POST | /ai/complete | Generic system + user prompt completion |
Plan & Trial
| Method | Endpoint | Description |
|---|---|---|
| GET | /plan | Live plan, quota, and upgrade info |
| GET | /trial | Self-serve trial status |
| POST | /trial | Start the self-serve trial |
API keys are minted from the dashboard (Settings → API Keys), not via the developer API — see API Keys & Scopes. /ai/research is a session-authenticated SSE stream used by the editor; it is documented under AI Tools but is not part of the Bearer mbk_... surface.
Response Format
All responses return JSON.
Success:
{ "id": "...", "slug": "...", "title": "..." }Error:
{ "error": "Human-readable message" }Rate Limits
All /blog/v1/* endpoints are limited to 100 requests per minute per API key.
When exceeded, the API returns 429 Too Many Requests:
{ "error": "Rate limit exceeded — 100 req/min" }OpenAPI Spec
Machine-readable spec available at:
GET https://api.misar.io/blog/v1/openapi.json