Social Media Analytics API
for Developers

One analytics endpoint for likes, impressions, reach, shares, and engagement across platforms. Build dashboards and reports without stitching vendor APIs.

Start for free

No credit card required

import { Configuration, AnalyticsApi } from "@onepostly/sdk";

const analyticsApi = new AnalyticsApi(
  new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }),
);

const { analytics } = await analyticsApi.getAnalytics({ post: postId });
console.log(analytics.subjects);

// → [{ platform: "x", metrics: { likes: 342, impressions: 12450 } }]import { Configuration, AnalyticsApi } from "@onepostly/sdk";

const analyticsApi = new AnalyticsApi(
  new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }),
);

const { analytics } = await analyticsApi.getAnalytics({ post: postId });
console.log(analytics.subjects);

// → [{ platform: "x", metrics: { likes: 342, impressions: 12450 } }]
import os

from onepostly import ApiClient, Configuration
from onepostly.api.analytics_api import AnalyticsApi

analytics_api = AnalyticsApi(ApiClient(
    Configuration(access_token=os.environ["ONEPOSTLY_API_KEY"])))

response = await analytics_api.get_analytics(post=post_id)
print(response.analytics.subjects)

# → [{"platform": "x", "metrics": {"likes": 342, "impressions": 12450}}]import os

from onepostly import ApiClient, Configuration
from onepostly.api.analytics_api import AnalyticsApi

analytics_api = AnalyticsApi(ApiClient(
    Configuration(access_token=os.environ["ONEPOSTLY_API_KEY"])))

response = await analytics_api.get_analytics(post=post_id)
print(response.analytics.subjects)

# → [{"platform": "x", "metrics": {"likes": 342, "impressions": 12450}}]
curl "https://api.onepostly.com/v1/analytics?post=POST_ID" \
  -H "x-api-key: op_YOUR_KEY"
 
# {
#   "analytics": {
#     "post": "POST_ID",
#     "subjects": [
#       { "platform": "x", "metrics": { "likes": 342, "impressions": 12450 } }
#     ]
#   }
# }

Trusted by developers and teams shipping across every platform

X Instagram Facebook Threads LinkedIn YouTube

The boring parts, handled

Every platform behind one integration

One integration covers publishing, scheduling, and analytics. Platform changes, app reviews, token refreshes, and rate limits are ours to absorb.

import { Configuration, PostsApi } from "@onepostly/sdk";

const posts = new PostsApi(

new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }),

);

await posts.createPost({

createPostBody: {

text: "Launch day!",

mediaKind: "video",

mediaUrls: ["https://cdn.example.com/launch.mp4"],

scheduledFor: "2027-06-01T09:00:00",

timezone: "America/New_York",

destinations: [

{ accountId: "conn_fb_214" },

{ accountId: "conn_tt_363" },

{ accountId: "conn_ig_486" },

});

import os

from onepostly import ApiClient, Configuration

from onepostly.api.posts_api import PostsApi

posts = PostsApi(ApiClient(

Configuration(access_token=os.environ["ONEPOSTLY_API_KEY"]),

))

await posts.create_post(

create_post_body={

"text": "Launch day!",

"mediaKind": "video",

"mediaUrls": ["https://cdn.example.com/launch.mp4"],

"scheduledFor": "2027-06-01T09:00:00",

"timezone": "America/New_York",

"destinations": [

{"accountId": "conn_fb_214"},

{"accountId": "conn_tt_363"},

{"accountId": "conn_ig_486"},

}

)

FacebookAccounts

TikTokAccounts

InstagramAccounts

Scales with your work

Features

Schedule, publish, and measure.

Changelog: faster media uploads

PublishedMon, 5 Oct09:30

Meet the new analytics view

PublishedTue, 6 Oct17:15

Planning your calendar, the short version

Thu, 8 Oct10:45Europe/Istanbul

We are at the API meetup today

Fri, 9 Oct13:00America/New_York

Case study: shipping every day

Mon, 12 Oct08:30Europe/London

Live demo: retries and webhooks

Tue, 13 Oct19:00Asia/Tokyo

Uptime report for last month

Wed, 14 Oct11:20America/Los_Angeles

Changelog: faster media uploads

PublishedMon, 5 Oct09:30

Meet the new analytics view

PublishedTue, 6 Oct17:15

Planning your calendar, the short version

Thu, 8 Oct10:45Europe/Istanbul

We are at the API meetup today

Fri, 9 Oct13:00America/New_York

Case study: shipping every day

Mon, 12 Oct08:30Europe/London

Live demo: retries and webhooks

Tue, 13 Oct19:00Asia/Tokyo

Uptime report for last month

Wed, 14 Oct11:20America/Los_Angeles

Post Scheduling

Pick the time and timezone. Nothing goes out until its scheduled moment, and you can cancel any time before.

ReelsText

Video

Photos

Story

Images, Videos & Carousels

Upload images, videos, carousels, Stories, and Reels. One payload, every destination.

Webhooks & Events

Publish, fail, comment, or DM. Every event hits your endpoint the moment it happens.

First Comment Support

Add a first comment to the same call. It publishes alongside the post where supported.

Normalized Analytics

One call returns likes, comments, and shares from every platform in the same shape.

Why Onepostly?

You call one API, we handle the rest.

Onepostly API

App reviews and OAuth handled
Platform apps and token refresh handled for you
One API key
Connect once and publish everywhere with one key
One shape for every surface
Comments DMs and metrics in normalized JSON
Platform changes absorbed
Endpoint contracts stay stable when APIs shift

Building it yourself (platform APIs)

A separate app per platform
App reviews and OAuth verification take months
A token refresh flow per platform
Rate limits and expiry tracking on your side
A different shape per platform
Inconsistent schemas across social networks
Every breaking change on you
API version bumps and deprecations to track

Beyond publishing

Comments, DMs, and metrics on the same API.

Same accounts, same API key. Conversations, moderation, automations, and numbers run through the integration you already have.

One agent for the whole social stack

› claude

Claude Code

MCP client

~/software

Inbox API

Conversations from every platform, one inbox

All platformsAll accounts

mira.buildsCan you send the setup guide?2m

kai.drawsLoved the launch post!14m

james.codesIs there a Python SDK?1h

Engagement API

Like, bookmark, and repost as API calls

MBmira.builds2h

Launch day is live. Everything shipped from one call.

128248

Automations API

Comment to DM automations

MB@mira.buildsGUIDE please

KD@kai.drawssend the GUIDE

MBmira.buildsHi! Sent the guide · now

KDkai.drawsHi! Sent the guide · 1m

Analytics API

Metrics from every platform, one shape

PlatformLikesCommentsShares

Instagram1,2848641

TikTok3,410214132

LinkedIn4863218

X7924563

Frequently asked questions

Metrics, subject filters, and how to pull normalized analytics into dashboards and reports.

It is a programmatic way to pull engagement metrics such as likes, impressions, reach, shares, and saves. Onepostly returns a normalized shape across supported platforms from one analytics endpoint.

Normalized fields include likes, comments, shares, saves, impressions, reach, plays, and engagement when the platform exposes them. Missing values stay null instead of fake zeros.

Call GET /v1/analytics with your x-api-key and the post id. Optionally pass accountId or destinationId to scope the response to a single connected account.

One Onepostly post can target multiple destinations. Without accountId you get metrics for every destination on that post. With accountId or destinationId you filter to one network or account.

Yes. Analytics are part of the API for every connected account, with nothing extra to unlock. Some X analytics reads debit the prepaid wallet at X list prices.

Yes. The analytics response is JSON-ready for custom dashboards, client reports, and automation. Use webhooks or polling only if you need status beyond a single pull.

Yes. The OAuth screens your users see carry neutral names like Social Media Connector rather than our brand, so the experience reads as fully yours.

Social Media Analytics APIfor Developers