Use case
A cross-platform social media analytics API
Socifyr exposes analytics for everything you publish through it. One API returns post-level engagement (likes, comments, shares, impressions, reach, clicks, saves and views where the platform provides them), follower growth per account, a side-by-side account comparison, and best posting times. The same data is available from the SDK, the CLI and MCP tools, so an agent can learn what worked and plan the next post.
cURLTypeScript SDKCLIMCP prompt
How it works
- 1
Publish through Socifyr
Metrics are collected for posts published through your workspace and synced from each platform. Trigger a refresh with POST /api/analytics/sync after publishing. - 2
Query a window
GET /api/analytics takes from, to, platform and a granularity. Dedicated endpoints return followers, accounts, best-times, top-posts and a per-post breakdown. - 3
Compare accounts
Followers and change, posts published, total engagement and average engagement per post, side by side for each connected account. - 4
Feed it back to your agent
get_post_analytics, get_follower_growth and compare_accounts are MCP tools, so the same assistant that posts can review results.
Working code
curl "https://api.socifyr.com/api/analytics?from=2026-10-01&to=2026-10-31&granularity=weekly" \
-H "Authorization: Bearer sk_your_key" \
-H "X-Workspace-Id: your_workspace_id"
curl "https://api.socifyr.com/api/analytics/followers" \
-H "Authorization: Bearer sk_your_key" \
-H "X-Workspace-Id: your_workspace_id"import { Socifyr } from '@socifyr/sdk'
const socifyr = new Socifyr({
apiKey: process.env.SOCIFYR_API_KEY!,
workspaceId: process.env.SOCIFYR_WORKSPACE_ID!,
})
const stats = await socifyr.analytics.get({
from: '2026-10-01',
to: '2026-10-31',
granularity: 'weekly',
})
const growth = await socifyr.analytics.followers()
const accounts = await socifyr.analytics.accounts()
const post = await socifyr.analytics.getPost(uploadId)socifyr analytics followers --from 2026-10-01 --to 2026-10-31
socifyr analytics accounts --platform xWhich of my posts last month got the most engagement? Compare my
accounts and suggest what to post this week.Replace sk_your_key and the workspace ID with your own from the dashboard, and use your own connection slugs.
Who this is for
Teams building reporting dashboards
Replace one integration per network with a single endpoint.Agents that optimize content
Close the loop: publish, measure, adjust.Agencies sending client reports
Export per-workspace numbers on a schedule.
Frequently asked questions
Which metrics are available?
Post-level likes, comments, shares, impressions, reach, clicks, saves and views where the platform exposes them, plus follower growth per account and an account comparison.
Does it include posts I published outside Socifyr?
Post analytics cover content published through Socifyr. Check the docs for current coverage of account-level follower data.
Are all platforms covered equally?
No. Each network limits what it reports. Follower counts are not available for LinkedIn and TikTok, and a few platforms have insight permissions that are still being approved.
How often is data refreshed?
Follower counts are captured once a day. You can trigger an engagement sync on demand with POST /api/analytics/sync.
Can I export the data?
Yes, there is an export endpoint at GET /api/analytics/export, and the dashboard also shows a best-times heatmap.