Analytics

Social media analytics API for your own product

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.

✓ Unlimited connected accounts · No separate charge for analytics reads
The data

Three endpoints, one key

Build a client report, a customer dashboard or an agent that reviews last week, without a parser per network.

Post analytics

GET /v1/posts/{id}/analytics

Likes, 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 reference

Account metrics

GET /v1/social-accounts/{id}/metrics

Follower, 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 reference

Audience demographics

GET /v1/social-accounts/{id}/audience-demographics

Available 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 reference
Coverage

Every metric, network by network

Including the gaps. For the reasons behind them, read our guide to what each network exposes.

NetworkPost analyticsAccount metricsAudience demographics
InstagramYesReturns 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).
FacebookYesLikes (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.
ThreadsYesViews, 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.
TikTokYes, once the video is publishedViews, likes, comments and shares. Drafts delivered with MEDIA_UPLOAD return an error until the creator publishes them.YesNoThe audience demographics endpoint supports Instagram and Facebook only.
YouTubeYesViews, 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.
XYesLikes, comments (replies), shares (reposts), views, impressions and engagement_rate.YesNoThe audience demographics endpoint supports Instagram and Facebook only.
LinkedInYesCompany 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
PinterestYesImpressions, 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
BlueskyYesIncludes 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 ProfileNoGoogle deprecated post-level insights with no replacement.YesDesktop and mobile impressions on Maps and Search, direction requests, phone call clicks and website clicks.No
VimeoYesPlays, likes and comment count. No impressions or reach.NoVimeo account-level insights are not exposed through Outstand.No
RedditYesScore, upvote ratio and comment count. Public data only, no impressions or reach.YesKarma snapshot: link, comment and total karma.No
Built for developers

From API key to first report

1. List the connected accounts

curl https://api.outstand.so/v1/social-accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

2. Read a post everywhere it was published

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

3. Add account and audience data

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.

Data quality

Know when a number is missing

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.

Limits to plan for

  • Networks do not count the same way. One schema gives you the same field names, not identical definitions, so compare trends within a network before comparing across them.
  • YouTube and Reddit do not report shares, so shares is 0 on both. Treat it as unavailable.
  • Bluesky, TikTok and YouTube account metrics are current or lifetime snapshots. The date range does not apply.
  • Instagram data can lag by up to 48 hours.
  • Facebook impressions and reach changed definition when Meta retired the old metrics on 15 June 2026. Do not chart both sides of that date as one series.
  • X reads run on your own X app and count against its quota or pay-per-use cost.
  • This is not social listening. Outstand does not track mentions, competitors or sentiment.
Pricing

Social media analytics API pricing

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

FAQ

Analytics API questions

What is a social media analytics API?

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.

Which networks does the Outstand social media analytics API support?

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.

Can I get analytics for posts I did not publish through Outstand?

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.

How do I tell zero engagement from missing data?

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.

Are analytics calls billed?

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.

Can an AI agent read these analytics?

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.

Build the report. Skip the integrations.

From $19/month including 3,000 posts, with unlimited connected accounts.