The Python SDK for social media posting
Schedule and publish to all 11 platforms from Python. Sync and async clients with identical method names, httpx as the only dependency, and type hints throughout.
Schedule your first post
1from fastapi import FastAPI2from omnisocials import AsyncOmniSocials34client = AsyncOmniSocials() # reads OMNISOCIALS_API_KEY5app = FastAPI()67@app.post("/launch")8async def launch(content: str):9post = await client.posts.create(10content=content,11channels=["instagram", "linkedin", "x"],12scheduled_at="2026-07-21T09:00:00Z",13)14return post["data"]
Built the way Python developers expect
Use OmniSocials in scripts and workers, or AsyncOmniSocials in FastAPI and asyncio apps. Same methods, same arguments, pick per call site.
httpx is the only requirement, Python 3.9+. Fully type-hinted with a py.typed marker, so your editor autocompletes everything.
Exponential backoff with jitter on rate limits, server errors and network failures. Honors Retry-After, never retries non-idempotent requests.
Stripe-style signature verification with constant-time comparison, so publish and engagement events reach your app safely.
Posts, media uploads, folders, accounts, analytics, best times, the social inbox and webhooks. Every v1 endpoint, one client.
The whole API, not a subset
The Python SDK covers every v1 endpoint, the same surface as the REST API.
Create, schedule, update and publish posts, stories and reels across all 11 platforms, including X threads and platform-specific options.
Upload images, video and PDFs from files, URLs or base64, up to 1GB via presigned uploads, with automatic compatibility checks per platform.
Pull per-post and per-account metrics, workspace overviews and best times to post, ready for your own dashboards.
Manage the social inbox from code: list DM, comment and mention conversations, pull full message threads, mark them read and send replies.
Subscribe to publish, failure and engagement events with signed payloads and a rotate-secret endpoint.
List connected accounts and organize content into folders, so your integration mirrors how the team works.
Search and validate taggable locations for platforms that support them.
Start building with Python today
One plan, every endpoint, all 11 platforms.
Everything you need to start:
- Unlimited scheduled posts
- Unified social inbox
- Basic analytics
- Schedule posts, stories & reels
- Invite colleagues and or clients to collaborate
- Public API & MCP server access
- 24/5 Support
Need more accounts or team features? View all plans →
Frequently asked questions
Can't find your question answered?
Reach out to support