Developers · Analytics API

The social media analytics API.Every post on the account, not only yours.

Breakreach's analytics API returns views, likes, comments, shares and engagement rate for every post on your Instagram, Facebook, Threads, X, YouTube and Bluesky accounts over up to 365 days, including posts made in the networks' own apps, plus followers and 28-day account stats on 10 networks. One key, one shape, sorted the way you ask.

OpenAPI spec

Checked against the API code on October 7, 2026. Breakreach is our product.

GET /v1/performance
curl "https://api.breakreach.com/v1/performance?days=30&sortBy=views&limit=3" \  -H "Authorization: Bearer $BREAKREACH_API_KEY"
GET /v1/performanceSending
{  "days": 30,  "totals": { "posts": 24, "views": 128410, "likes": 7215,              "comments": 412, "shares": 655 },  "byPlatform": { "instagram": { "posts": 9, "views": 71204, … } },  "posts": [    { "platform": "instagram", "date": "2026-09-16",      "text": "Meet Morning Light, our new blend.",      "views": 31840, "likes": 2210, "comments": 148,      "shares": 310, "engagementRate": 8.4 },    …  ]}
Last 30 daysAll accounts
Views
Likes
Comments
Shares
Top posts by views
Meet Morning Light, our new blend.31.8K8.4%
Inside the roastery at 5 AM18.2K6.1%
Latte art tip: the rosetta in 20 seconds.9.6K5.2%
The last 30 days of every connected account, top posts by views, with totals per network. Cached for an hour unless you pass refresh=1.

Analytics API endpoints6 endpoints, one API key.

  • GET/v1/performanceEvery post on the accounts over N days (up to 365): views, likes, comments, shares, engagement rate, totals per network
  • GET/v1/post-insightsEverything about one post: every lifetime metric the network exposes, its comments, and a comparison with the account's average post
  • GET/v1/posts/:id/metricsViews, likes, comments and shares for one post published with Breakreach, with its network post ids
  • GET/v1/analyticsTotals across your last 100 Breakreach posts and the top 10 by views
  • GET/v1/accounts/statsFollowers, plus 28-day views, reach, engagement and profile views where the network gives them
  • GET/v1/accounts/trendsDaily account numbers over up to 90 days: Facebook Page views, engagement and followers, Instagram reach, Threads views

Base URL https://api.breakreach.com. Every call sends your key as Authorization: Bearer br_…; errors answer { "error": "…" } with a 4xx or 5xx status. Every parameter is in the OpenAPI spec.

What GET /v1/performance takes

FieldTypeWhat it does
daysnumberHow far back, 1 to 365 (default 30)
sortBystringdate, views, likes, comments, shares or engagement
limitnumberPosts returned, 1 to 200 (default 25)
platformstringOne network only
accountIdstringOne account only
refreshbooleanRebuild from the networks instead of the one-hour cache

Which networks it coversChecked against the code, not a feature list.

NetworkEvery post on the accountPosts made with BreakreachAccount stats
InstagramYesYesYes, Followers, reach, views, profile views
Facebook PagesYesYesYes, With daily trends
ThreadsYesYesYes, With daily views
XYesYesYes
YouTubeYesYes, Through the accountYes
BlueskyYesYesYes
RedditNoYes, Without viewsYes
MastodonNoYes, Without viewsYes
TikTok, Pinterest, TelegramNoNoYes, Followers and totals
LinkedInNoNoNo
Discord, Slack, WordPressNoNoNo
Checked on October 7, 2026, against Breakreach's metrics code. LinkedIn keeps member post statistics behind a vetted API; TikTok per-video stats aren't in yet.

Does it count posts I didn't publish with Breakreach?Yes, on six networks.

GET /v1/performance reads the posts of the whole account on Instagram, Facebook, Threads, X, YouTube and Bluesky, wherever they were published, so a report covers what you posted from the phone too. On the other networks it only knows the posts that went out through Breakreach.

Metrics are lifetime counts, dated by the day the post went out. The engagement rate is likes, comments and shares over views, as a percentage, and comes back null for a post without views. The result is cached for an hour per workspace; refresh=1 rebuilds it from the networks.

How do I get every metric for one post?

GET /v1/post-insights?accountId=…&postId=… takes the network's post id (the id in /v1/performance) and returns everything the network exposes for it: views, reach, reactions by type, clicks, saves, profile visits, Reel plays, watch time and the retention curve where they exist, plus its comments and how it compares with the account's average post.

For a post you published through Breakreach, GET /v1/posts/:id/metrics returns the four headline numbers summed across the networks it went to, and refresh=1 fetches them fresh. They are also on each post in GET /v1/posts.

Can I get follower counts?

GET /v1/accounts/stats returns followers for every connected account, and the last 28 days of views, reach, engagement and profile views where the network gives them: Instagram, Facebook, Threads, YouTube, X, TikTok, Pinterest, Reddit, Bluesky and Telegram. It's cached for up to an hour, like the dashboard.

GET /v1/accounts/trends?days=30 returns the day by day series straight from the networks' insights (Facebook Page views, engagement and followers, Instagram reach, Threads views), including days without a new post, with a summary per account.

What do people build with it?

  • Client reportsAn agency loops over its workspaces, calls /v1/performance for the month and writes a PDF per client.
  • A weekly digest in SlackA cron job posts the top three posts of the week and the follower change.
  • An agent that plans from numbers“What did best last month, and when should I post the next one?” reads /v1/performance, then schedules with useNextSlot.

What does the analytics API cost?

The Developer plan costs $5 a month per connected account up to 20, $3 from 21 to 100 and $2 after that, never per call or per post. The API also comes with every regular plan, from Starter at $29 a month for 5 accounts. Analytics calls aren't counted.

For AI agents

Agents get the same calls.As MCP tools, no code to write.

Agents read the same numbers: “how did last week's posts do, and what should I post next?” returns a real answer in Claude Code, Codex or OpenClaw, from your accounts rather than a guess.

  • get_content_performance“How did last week's posts do?”, sorted the way you ask
  • get_post_insightsEverything about one post, against the account average
  • get_account_statsFollowers and 28-day numbers per account
  • get_account_trendsDay by day reach and views
  • get_analyticsTotals and top posts made with Breakreach
  • get_post_metricsOne Breakreach post's numbers

What the analytics API doesn't do yetSo you know before you build.

  • LinkedIn post stats: LinkedIn keeps them behind its vetted Community Management API
  • TikTok per-video views and likes: account totals only, for now
  • Pinterest per-pin stats
  • Competitors' accounts: only accounts you connect
  • Demographics of your audience

The rest of the API (webhooks, workspaces per customer, connect links for your users, the price per connected account) is on the developers page.

FAQ

Questions, answered.

Short answers about the Analytics API.

Breakreach returns per-post views, likes, comments, shares and engagement rate for Instagram, Facebook, Threads, X, YouTube and Bluesky in one shape, and follower counts on 10 networks.

Yes on Instagram, Facebook, Threads, X, YouTube and Bluesky, where GET /v1/performance reads the whole account. Elsewhere it covers posts published through Breakreach.

Up to an hour old: results are cached per workspace for an hour. Pass refresh=1 to rebuild them from the networks.

Not per post. LinkedIn keeps member post statistics behind a vetted API, and TikTok per-video stats aren't in yet; TikTok account totals are available.

Up to 365 days for posts, and 90 days for the daily account trends.

Instagram
TikTok
LinkedIn
YouTube
X
Facebook
Threads

Your first call is five minutes away.From $5 a month per account.

Billed per connected account. Cancel anytime.