Chirio

Multi-tenant social publishing API. Connect accounts through hosted OAuth, publish or schedule to Instagram, Threads, X and LinkedIn with one call.

Published 1mo ago

Changelog

One call, many networks

Chirio is a social publishing API. Your users connect their social accounts through a hosted OAuth flow you never have to implement, and you publish to all of them with a single HTTP request.

Supported platforms: Instagram, Threads, X and LinkedIn (personal profiles and company pages) — plus Supa Hub, for publishing into self-hosted Supa Social communities, connected with an API key instead of OAuth.

await fetch("https://chirio.dev/api/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHIRIO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Launch day!",
    mediaItems: [{ type: "image", url: "https://cdn.yourapp.com/launch.jpg" }],
    platforms: [
      { platform: "instagram", accountId: igAccountId },
      { platform: "linkedin", accountId: liAccountId },
    ],
  }),
});

What it gives you

Hosted OAuth. One POST returns an authorize URL. Send your user there; they come back to your own redirect with an accountId. No per-platform OAuth code in your app, and no platform app of your own to register and get reviewed.

One publish call. Fan-out to up to 10 targets happens server-side, concurrently, with a per-target result you can act on.

Per-target outcomes. Mixed success is a first-class result, not an exception — each target reports its own status, url and error.

Publish now or later. Add publishAt and Chirio holds the post until then — you do not need a scheduler, a cron or a machine that stays awake.

Per-target content. One post can carry a different caption or a different crop per platform, instead of forcing you into one post per network.

Carousels and first comments. Multi-image Instagram and Threads posts, plus the link-in-the-comments pattern, without extra calls.

Safe retries. An idempotency key makes a timed-out publish safe to send again.

Live engagement metrics. Read a post's views, likes, comments, shares and saves per target with one call — see the Posts reference.

Reposts. Reshare a post that performed, or any other post URL, from the accounts you have connected.

One call, many networks

Chirio is a social publishing API. Your users connect their social accounts through a hosted OAuth flow you never have to implement, and you publish to all of them with a single HTTP request.

await fetch("https://chirio.dev/api/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHIRIO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Launch day!",
    mediaItems: [{ type: "image", url: "https://cdn.yourapp.com/launch.jpg" }],
    platforms: [
      { platform: "instagram", accountId: igAccountId },
      { platform: "linkedin", accountId: liAccountId },
    ],
  }),
});