Python SDKSocial media SDK
Social media SDK
for Python
Post, schedule, reply and report on 13 platforms from Python, with a sync and an async client.
TerminalInstall in one lineFrom PyPI, for Python 3.9 or later. The source is on GitHub under MIT.pip install omnisocials
Sync and asyncUse OmniSocials in scripts and workers, or AsyncOmniSocials in FastAPI and asyncio apps. Same methods, same arguments, pick per call site.AsyncOmniSocials
One light dependencyhttpx is the only requirement, Python 3.9+. Fully type-hinted with a py.typed marker, so your editor autocompletes everything.httpx
Fits the Python stack you use
The same client in FastAPI, Flask and Django. Each example schedules a post from your own code.
FastAPI~/released
1from fastapi import FastAPI
2from omnisocials import AsyncOmniSocials
3
4client = AsyncOmniSocials() # reads OMNISOCIALS_API_KEY
5app = FastAPI()
6
7@app.post("/launch")
8async def launch(content: str):
9 post = await client.posts.create(
10 content=content,
11 channels=["instagram", "linkedin", "x"],
12 scheduled_at="2026-11-03T09:00:00Z",
13 )
14 return post["data"]
One client for the whole API
Posts, media, the inbox, analytics and webhooks sit on the same client, with the same names in every language.
Retries, errors and webhook checks built in
All eight follow one design. They retry what fails for a moment, raise a clear error for the rest and check every webhook signature.
Automatic retriesRate limits, server errors and dropped connections retry with backoff. Retry-After is respected.2 retries by default
Errors you can catchOne class per failure: authentication, validation, not found, rate limit, server and connection.RateLimitError
Timeouts you setSet the timeout, the retry count and the base URL per client. The defaults fit most apps.30 s per attempt
Webhook checksHMAC-SHA256 with a constant-time compare and a 5-minute replay window.verify_webhook_signature()
The Python package
Released with the other seven SDKs from one changelog. Need another language? See all eight on the SDK page.
All SDKs- Package
omnisocials- Install
- Version
- 0.9.0Released Oct 5, 2026
- Requires
- Python 3.9 or later
- Dependencies
- httpx only
- Client
OmniSocials()- Responses
- Plain dicts
- Webhooks
verify_webhook_signature()- Source
- OmniSocials/omnisocials-python MIT license
Frequently
Asked Questions
Robert LigthartFounder of OmniSocials
Install it.Post today.
The SDKs, the API, the CLI and the MCP server come with every plan: $10 per seat per month, billed annually.