Python SDK
Install and use the MisarBlog Python SDK
Installation
pip install misar-blog
Quick Start
from misar_blog import MisarBlogClient
client = MisarBlogClient(api_key=os.environ["MISARBLOG_API_KEY"])
# Fetch posts for a user
posts = client.posts.list(username="johndoe")
for post in posts.data:
print(post.title, post.slug)
Generate an Embed URL
url = client.embed.url(username="johndoe", theme="dark")
print(url) # https://misar.blog/embed/johndoe?theme=dark
# Single post
url = client.embed.url(username="johndoe", slug="my-first-post", theme="light")
Available Methods
| Method | Description |
|--------|-------------|
| client.posts.list(username, params) | List posts for a user |
| client.posts.get(username, slug) | Get a single post by slug |
| client.embed.url(username, slug, theme) | Generate an embed URL |
| client.auth.refresh_token(token) | Refresh a session token |
| client.webhooks.list() | List webhook endpoints |
| client.webhooks.create(request) | Register a webhook |
| client.webhooks.delete(id) | Delete a webhook |
Error Handling
from misar_blog.exceptions import MisarBlogAPIError, MisarBlogNetworkError
try:
posts = client.posts.list(username="johndoe")
except MisarBlogAPIError as e:
print(f"API error {e.status_code}: {e.message}")
except MisarBlogNetworkError as e:
print(f"Network error: {e}")