Chirio

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

Published 2d ago

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

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.
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.
Encrypted credentials and automatic refresh. Platform tokens are encrypted at rest and refreshed before they lapse.

How the pieces fit

A project owns everything. It holds API keys (shown once, stored hashed), the social accounts connected under it, and the posts published through it. Projects are isolated from one another, so a product publishing on behalf of its own users can keep one project per customer. Publishing is metered in network writes — one per target, plus one per first comment that posts. See Metering for how that is priced.

Start here

No pages in this collection yet.

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

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.

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.

Encrypted credentials and automatic refresh. Platform tokens are encrypted at rest and refreshed before they lapse.

How the pieces fit

Publishing is metered in network writes — one per target, plus one per first comment that posts. See Metering for how that is priced.

Start here

No pages in this collection yet.