Read post analytics, account metrics and audience demographics with one API key. The response format stays the same across networks, and the table below shows exactly what each of the 12 does and does not return.
Build a client report, a customer dashboard or an agent that reviews last week, without a parser per network.
GET /v1/posts/{id}/analyticsLikes, comments, shares, views, impressions, reach and engagement rate where the network reports them. You get one row per account the post reached, plus totals. Network-only metrics sit under platform_specific.
Post analytics referenceGET /v1/social-accounts/{id}/metricsFollower, following and post counts, with engagement where the network exposes it. Pass since and until as Unix timestamps on networks that keep history. The default window is the last 30 days.
Account metrics referenceGET /v1/social-accounts/{id}/audience-demographicsAvailable on Instagram and Facebook only. Instagram breaks an audience down by country, city, age and gender. Facebook covers country and city. Each value comes with its share of the total.
Audience demographics referenceIncluding the gaps. For the reasons behind them, read our guide to what each network exposes.
| Network | Post analytics | Account metrics | Audience demographics |
|---|---|---|---|
| YesReturns likes, comments, saves, shares, views, reach and engagement_rate where Meta reports them. | YesViews, likes, comments, shares, saves, reach, accounts engaged, total interactions. Requires the instagram_business_manage_insights permission. | Yes: country, city, age, genderFollowers or engaged accounts, last 7 or 30 days. Meta limits this to the top 45 values and needs at least 100 followers (or 100 engagements). | |
| YesLikes (LIKE reaction only), comments, shares, impressions, reach and engagement_rate. Values Meta does not report are null. Needs the Analyze task on the Page. | YesImpressions, reach and post engagements for the period. | Followers only: country and cityMeta retired Page age, gender and language metrics, so those are not available. Pages need at least 100 followers. | |
| Threads | YesViews, likes, comments (replies), shares (reposts plus quotes) and engagement_rate. | YesViews, likes, replies, reposts, quotes and followers count. Needs the threads_manage_insights permission. | NoThe audience demographics endpoint supports Instagram and Facebook only. |
| TikTok | Yes, once the video is publishedViews, likes, comments and shares. Drafts delivered with MEDIA_UPLOAD return an error until the creator publishes them. | Yes | NoThe audience demographics endpoint supports Instagram and Facebook only. |
| YouTube | YesViews, likes and comments. | Lifetime channel statistics onlySubscribers, video count and total channel views. Not limited to the date range you pass. | NoThe audience demographics endpoint supports Instagram and Facebook only. |
| X | YesLikes, comments (replies), shares (reposts), views, impressions and engagement_rate. | Yes | NoThe audience demographics endpoint supports Instagram and Facebook only. |
| YesCompany Pages return likes, comments, shares, clicks, impressions and engagement rate. Personal profiles return likes, comments, shares, impressions, reach and engagement rate, with no clicks. Company Pages need the ADMINISTRATOR role. Share statistics cover the past 12 months. | Partly: Company Pages get engagement, personal profiles do notCompany Pages return likes, comments, shares, clicks, impressions, unique impressions and engagement rate. Personal profiles return follower and connection counts only. | No | |
| YesImpressions, saves, pin clicks and outbound clicks over the last 90 days. | YesFollowers, following, pin count, plus impressions, saves, pin clicks and outbound clicks for a date range. | No | |
| Bluesky | YesIncludes reply and repost counts from Bluesky. | Partly: snapshot onlyFollowers, following and post count as a current snapshot. The date range is ignored. No engagement metrics. | No |
| Google Business Profile | NoGoogle deprecated post-level insights with no replacement. | YesDesktop and mobile impressions on Maps and Search, direction requests, phone call clicks and website clicks. | No |
| Vimeo | YesPlays, likes and comment count. No impressions or reach. | NoVimeo account-level insights are not exposed through Outstand. | No |
| YesScore, upvote ratio and comment count. Public data only, no impressions or reach. | YesKarma snapshot: link, comment and total karma. | No |
curl https://api.outstand.so/v1/social-accounts \ -H "Authorization: Bearer YOUR_API_KEY"
const base = 'https://api.outstand.so/v1';
const headers = { Authorization: `Bearer ${process.env.OUTSTAND_API_KEY}` };
const res = await fetch(`${base}/posts/${postId}/analytics`, { headers });
if (!res.ok) throw new Error(`Analytics request failed: ${res.status}`);
const { metrics_by_account, aggregated_metrics } = await res.json();
for (const row of metrics_by_account) {
const { network, username } = row.social_account;
// A failed account is reported, not dropped. Do not chart it as zero.
if (row.metrics === null) {
console.warn(network, username, row.metrics_error?.code);
continue;
}
console.log(network, username, row.metrics.views ?? 'not reported');
}
// Totals only include accounts that could be read, so they can be partial.
console.log(aggregated_metrics.total_likes);curl "https://api.outstand.so/v1/social-accounts/ACCOUNT_ID/metrics?since=1790812800&until=1793491200" \ -H "Authorization: Bearer YOUR_API_KEY" curl "https://api.outstand.so/v1/social-accounts/ACCOUNT_ID/audience-demographics?breakdown=country" \ -H "Authorization: Bearer YOUR_API_KEY"
Need a file rather than a dashboard? See exporting reports to CSV or BI. Need older posts in the report? Import them from a connected account first.
When one account cannot be read, the others still return. The failed one has metrics: null and a metrics_error with one of these codes.
token_expiredThe connection needs to be authorized again.scope_missingThe account did not grant the permission the metric needs.post_not_foundThe post is unavailable or not visible to this account. It is not proof of deletion.metrics_expiredThe network no longer serves metrics for this content.unknownAnything else. The message field carries the detail.$19/month includes 3,000 posts. After that, posts cost $0.007 each up to 10,000 a month, then $0.005. Connected accounts are unlimited, and there is no separate charge for analytics reads.
Two other things are metered if you use them: direct message conversations beyond your allowance ($0.025 each) and processed video ($0.05 per 10 seconds of output). The facts page has the full, dated price list.
It is an API that returns performance data from social networks, such as views, likes, reach and follower counts, so your own product can store or display it. A unified one puts several networks behind one key and one response format, which saves you a separate app registration, token flow and parser for each.
Post analytics cover 11 of 12 networks: Instagram, Facebook, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Vimeo, and Reddit. Google Business Profile has location metrics instead, because Google retired post-level insights. Audience demographics cover Instagram and Facebook.
Yes, for your own connected accounts on networks that support imports: Bluesky, LinkedIn company pages, Facebook, Instagram, Threads, TikTok, YouTube, Pinterest and Google Business Profile. Once imported, a post has an Outstand id you can use on the analytics endpoint, where the network offers post analytics. Each imported post counts as one post on your bill. Posts from accounts you have not connected are not available.
If an account could not be read, its metrics object is null and metrics_error carries a code such as token_expired or scope_missing. Fields a network does not report may also be null. Totals exclude accounts that failed, so check every row before you treat a total as complete.
There is no separate charge for analytics reads. Outstand bills posts, direct message conversations and processed video. Importing older posts uses your post allowance, and X may bill your own X app for reads.
Yes. The MCP server exposes get_post_analytics, get_account_metrics and get_audience_demographics, so an MCP client can pull the same data without custom code.
From $19/month including 3,000 posts, with unlimited connected accounts.