What is the difference between an API and an SDK?

The API is the HTTP interface at https://api.omnisocials.com/v1. An SDK is a package for your language that calls it for you: it sends your key, retries rate limits and server errors, raises clear errors and checks webhook signatures. Both reach the same features.

Is there a Python library to post to social media?

Yes. pip install omnisocials installs the official OmniSocials SDK for Python 3.9 and later, with a sync and an async client. It posts to Instagram, Facebook, LinkedIn, X, TikTok, YouTube, Threads, Pinterest, Bluesky, Mastodon, Google Business, Telegram and Discord once the accounts are connected in OmniSocials.

Do I need my own developer app for each platform?

No. You connect each account once in the OmniSocials app with the platform's own sign-in (Telegram: press Start in the OmniSocials bot; Discord: Continue with Discord, or paste a webhook URL). After that, every API key of the workspace can post to it. The SDKs and the API do not connect accounts themselves.

Can I post Instagram Stories, Reels or TikTok videos with an SDK?

Yes. Stories, Reels and videos go through the same create call as any post, with media you upload first or pass as a public URL: up to 100 MB as a direct upload, up to 1 GB from a URL. Platform options, such as a first comment on TikTok, go in the same request.

Are the OmniSocials SDKs open source?

Yes. All eight are public on GitHub under the MIT license, in the OmniSocials organisation. They ship together with one version number, now 0.9.0. Java builds from its GitHub repository until it is on Maven Central.

Can I use OmniSocials from a language without an SDK?

Yes. The REST API works from any language that can send HTTP and JSON. Send your API key as a Bearer token to https://api.omnisocials.com/v1, at up to 100 requests per minute per key.

Is there a sandbox or test mode?

No, there are no test keys. Leave out scheduled_at and a post stays a draft, so you can build against a real workspace without publishing. Many teams also keep a separate workspace with test accounts.

The SDKs are free and open source. They need an API key, which comes with every OmniSocials plan: $10 per seat per month billed annually, or $12 billed monthly. You can try it for 14 days first.

Official SDKs

Social media SDKs
for eight languages

Official clients for Node.js, Python, Go, Rust, .NET, Java, PHP and Ruby. Post, schedule, reply and report on 13 platforms from the code you already write.

Get API key Read the docs

app.omnisocials.com/calendar

Released

2

Home

Create Post

Calendar

Posts

Analytics

Social Inbox

2

Automations

Approvals

1

Library

Latest updateDiscord channels

#announcements

OmniSocialsAPP924

1/3

JJens

Today

Week 43, 2026

WeekMonth

Mon

19

Tue

20

Wed

21

Thu

22

Fri

23

Sat

24

Sun

25

Posted

6:03 PM

A priority field cannot tell you whether...

Posted

9:00 AM

This is Beamer working for you... or not...

Scheduled

8:10 PM

Jira just got personal.

Draft

10:00 AM

We’ve put together a set of Jira how-to ...

In approval

10:00 AM

“Ready to configure” is a strange status...

Scheduled

9:00 AM

A roadmap you share with stakeholders an...

launch.ts~/released

1import { OmniSocials } from "@omnisocials/sdk";
2 
3const client = new OmniSocials(); // reads OMNISOCIALS_API_KEY
4 
5const { data: post } = await client.posts.create({
6  content: "We’ve just added Jira Assets support…",
7  channels: ["linkedin", "x", "facebook"],
8  scheduled_at: "2026-10-23T07:00:00Z",
9});
10 
11console.log(post.id, post.status);

Terminalnpm install @omnisocials/sdk

Webhooksyour-app.com/hooks

post.published10191 h ago200

post.approved10233 h ago200

Signed with HMAC-SHA256

launch.ts~/released

1import { OmniSocials } from "@omnisocials/sdk";
2 
3const client = new OmniSocials(); // reads OMNISOCIALS_API_KEY
4 
5const { data: post } = await client.posts.create({
6  content: "We’ve just added Jira Assets support…",
7  channels: ["linkedin", "x", "facebook"],
8  scheduled_at: "2026-10-23T07:00:00Z",
9});
10 
11console.log(post.id, post.status);

Terminalnpm install @omnisocials/sdk

Install in one lineFrom npm, PyPI, Go modules, crates.io, NuGet, Packagist or RubyGems. Java builds from GitHub until it is on Maven Central.npm install @omnisocials/sdk

Your key from the environmentEvery client reads OMNISOCIALS_API_KEY. Create the key in Settings, API.OMNISOCIALS_API_KEY

The same names in every languagecontent, channels and scheduled_at mean the same in all eight, so one guide fits every stack.content, channels, scheduled_at

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.

app.omnisocials.com/posts

Released

2

Home

Create Post

Calendar

Posts

Analytics

Social Inbox

2

Automations

Approvals

1

Library

Latest updateDiscord channels

#announcements

OmniSocialsAPP924

1/3

JJens

Posted44Scheduled2Drafts1In approval1Rejected0Failed1

Platforms

Views

Likes

Comments

Search posts...

Post	Platforms	Views	Likes	Comments
We’ve just added Jira Assets support to boards in Jira. Oct 23, 2026, 9:00 AM		–	–	–	Edit
A roadmap you share with stakeholders and a changelog you publish to customers aren’t the same thing. Oct 25, 2026, 9:00 AM		–	–	–	Edit

media.ts~/released

1const { data: video } = await client.media.uploadFromUrl({
2  url: "https://example.com/jira-assets.mp4",
3});
4 
5await client.posts.create({
6  content: "We’ve just added Jira Assets support…",
7  channels: ["instagram", "linkedin"],
8  media_ids: [video.id],
9  scheduled_at: "2026-10-23T07:00:00Z",
10});

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.

errors.ts~/released

1import {
2  OmniSocials, RateLimitError, ValidationError,
3} from "@omnisocials/sdk";
4 
5const client = new OmniSocials({ maxRetries: 5, timeout: 60000 });
6 
7try {
8  await client.posts.publish("1019");
9} catch (err) {
10  if (err instanceof RateLimitError) console.log(err.retryAfter);
11  else if (err instanceof ValidationError) console.log(err.code);
12  else throw err;
13}

Requestsclient.posts.create()

1POST/v1/posts429 Too Many Requests
2POST/v1/posts503 Service Unavailable
3POST/v1/posts201 Created
Sending…

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.verifyWebhookSignature()

Eight packages, one version

All eight ship together from one changelog, now at 0.9.0. Each one is open source on GitHub under the MIT license.

LanguageInstallRequiresLinks

Node.jsnpmNode 18+Guide GitHub

PythonPyPIPython 3.9+Guide GitHub

GoGo modulesGo 1.26+Guide GitHub

Rustcrates.ioRust 1.75+Guide GitHub

.NETNuGet.NET 8Guide GitHub

JavaGitHubJava 11+Guide GitHub

PHPPackagistPHP 8.1+Guide GitHub

RubyRubyGemsRuby 3.0+Guide GitHub

Frequently
Asked Questions

Robert LigthartFounder of OmniSocials

Ask me a question

Still have a question?Ask Robert, the founder

Ask

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.

Get API key Read the docs

launch.ts

const { data: post } = await client.posts.create({
  content: "We’ve just added Jira Assets support…",
  channels: ["linkedin", "x", "facebook"],
  scheduled_at: "2026-10-23T07:00:00Z",
});
 
console.log(post.id, post.status);

~/releasedzsh
$npm install @omnisocials/sdkadded 1 package in 1s$node launch.ts1024 scheduled

Social media SDKsfor eight languages

One client for the whole APIself.__wrap_n!=1&&self.__wrap_b("«Rabeh5»",1)

Retries, errors and webhook checks built inself.__wrap_n!=1&&self.__wrap_b("«Raceh5»",1)

Eight packages, one versionself.__wrap_n!=1&&self.__wrap_b("«Radeh5»",1)

Frequently Asked Questionsself.__wrap_n!=1&&self.__wrap_b("«R5ueh5»",1)