MisarPost Python SDK

Schedule, publish, generate and analyze social content from Python — sync and async, from the same client.

17 resource groups · 102 methods · 102 async mirrors

MisarPost is the AI social command center: publish to X, LinkedIn, Instagram, Threads, Bluesky, TikTok and more from one API, repurpose long-form content with ContentRipple, research trends with TrendPulse and write in your own voice with PersonaForge.

Every resource method has an a-prefixed async twin (posts.list / posts.alist) on the same client. Python 3.9+, httpx the only runtime dependency. The resource layer is generated from the API's own route tree, so it always matches the server.

Install

pip

pip install misarpost

uv

uv add misarpost

Authentication

Create an API key at https://post.misar.io/dashboard/api-keys. It starts with mpk_ and is sent as Authorization: Bearer mpk_…. Each key carries scopes (posts:read, schedule:write, generate:write, …); a call outside them answers 403 with code: "insufficient_scope". New keys get every scope unless you narrow them.

import os
from misarpost import MisarPostClient

post = MisarPostClient(os.environ["MISARPOST_API_KEY"])

Resources

Every group the client exposes, every method on it, and the scope a key needs. Each method also has an a-prefixed async twin.

Methods take path parameters positionally, then body (a dict, when the endpoint reads one), then an optional query dict.

Client

Quick start

from misarpost import MisarPostClient

post = MisarPostClient("mpk_your_key")

accounts = post.connections.list()["accounts"]
draft = post.generate.create({"prompt": "Announce our v2 launch", "platforms": ["linkedin"]})
post.posts.schedule({
    "accountIds": [accounts[0]["id"]],
    "content": "We just shipped v2",
    "scheduledAt": "2026-11-01T09:00:00Z",
})

Pagination

from misarpost import paginate

for page in paginate(lambda n: post.posts.list({"status": "queued", "page": n})):
    for item in page["posts"]:
        print(item["id"])

Plan limits

When a monthly allowance is spent, or a feature is not on the plan, the API answers 402 with code: "plan_limit_exceeded" and an upgrade offer. The SDK detects the code before it looks at the status, raises MisarPostPlanLimitError, and never retries it. All copy (headline, plans, prices, URLs) comes from the server.

from misarpost import MisarPostPlanLimitError

try:
    post.generate.enhance({"content": "…"})
except MisarPostPlanLimitError as e:
    print(e.offer["headline"], e.offer["cta"])
    print("Upgrade:", e.upgrade_url, "resets in", e.retry_after, "s")

Webhooks

from misarpost import verify_webhook_signature

ok = verify_webhook_signature(secret, raw_body, request.headers.get("X-MisarPost-Signature"))

Method reference

Links

• Website — https://www.misarpost.com
• App — https://post.misar.io
• Parent — https://misar.io
• Documentation — https://docs.misar.io/post
• API reference — https://api.misar.io/post/openapi.json
• Source — https://github.com/Misar-AI/misarpost-sdks
• PyPI — https://pypi.org/project/misarpost/

MIT © Misar.AI