Overview

Onepostly supports 9 major social media platforms. Each platform page includes quick start examples, media requirements, and platform-specific features.

Platform Quick Reference

A No means the platform API does not expose the capability.

Getting Started

1. Connect an Account

Each platform uses OAuth through the dashboard: open Dashboard → Connections, pick a platform, and complete the consent screen. Headless connects are available for some platforms, see Connection.

Every connection has an id you pass as accountId when publishing:

const { connections: list } = await connections.listConnections();
console.log(list);

// [{ "id": "YOUR_ACCOUNT_ID", "platform": "x", "handle": "@yourhandle", "status": "active" }]

2. Create a Post

Once connected, create a post targeting a specific platform:

const { post } = await posts.createPost({
  createPostBody: {
    text: "Hello from Onepostly",
    mediaKind: "text",
    destinations: [{ accountId: "YOUR_ACCOUNT_ID" }],
  },
});

3. Cross-Post to Multiple Platforms

Post to multiple platforms simultaneously: same content, one call, one entry per destination:

const { post } = await posts.createPost({
  createPostBody: {
    text: "Cross-posting to all my accounts!",
    mediaKind: "text",
    destinations: [
      { accountId: "YOUR_X_ACCOUNT_ID" },
      { accountId: "YOUR_INSTAGRAM_ACCOUNT_ID" },
      { accountId: "YOUR_BLUESKY_ACCOUNT_ID" },
    ],
  },
});

Analytics KPIs Matrix

Which normalized metrics does the Analytics API return for each platform?

* YouTube shares only when YouTube Analytics reports them

Notes:

• TikTok and Threads report views: Onepostly maps them to both impressions and plays
• LinkedIn and Pinterest do not expose post analytics through this API
• Missing values are null, never zero

Comments and Engagement

Which interactions each platform supports on published posts:

A dash means the platform API does not expose the action.

API Reference

• Connection - OAuth flows for all platforms
• Media - Image and video uploads
• Analytics Freshness - When metrics become available
• Webhooks - Real-time publish events
• Errors & Billing - Error codes and the X wallet