Misar.Blog Python SDK

Official Python client for the Misar.Blog developer API. Sync and async, typed models, retry with back-off.

Install

pip install misarblog

Quick start

from misarblog import MisarBlogClient, MisarBlogPlanLimitError

blog = MisarBlogClient("mbk_...")

me = blog.me.get()
article = blog.articles.publish(title="Hello", body_markdown="# Hi")
thread = blog.comments.list(article["id"], limit=50)
follows = blog.follows.status(me["id"])

try:
    blog.ai.complete(prompt="Draft an intro paragraph")
except MisarBlogPlanLimitError as err:
    print(f"{err.plan} plan is out of credits — upgrade at {err.upgrade_url}")

Every method has an a-prefixed async twin:

me = await blog.me.aget()
await blog.aclose()

Authentication and plan gating

Every call goes through the metered gateway at https://api.misar.io/blog/v1 with your developer key as a Bearer token. Mint a key in the dashboard at https://www.misar.blog/dashboard/settings/api — key management is a cookie-session flow and is deliberately not exposed by this SDK.

Feature access and throughput follow the subscription attached to that key:

The last two raise MisarBlogPlanLimitError rather than a generic error, carrying the plan slug, the pricing URL and (when the API supplies it) seconds until reset. Show the upgrade URL instead of reporting a bare failure — the SDK does not retry these, because retrying cannot change the outcome.

Covered operations

All 25 key-authenticated operations:

The API exposes no SSE or WebSocket endpoint that accepts an API key, so this SDK is request/response only. See openapi/blog.openapi.json for the machine-readable contract.

Links

• API docs — https://docs.misar.io/blog
• OpenAPI spec — https://api.misar.io/blog/v1/openapi.json
• Dashboard — https://www.misar.blog/dashboard/settings/api

License

MIT — see LICENSE.