Use casesAnalytics API
Post and account analytics, normalised
Impressions, reach, engagement and follower counts mean slightly different things on every network. Siar returns them in one shape and keeps the original payload next to it, so you can chart across networks or drill into what a network actually said.
- Post analytics and account analytics under one set of endpoints.
- Raw network payloads available at
/rawvariants. - Bulk read for many posts at once; force a refresh on demand.
- Backfill content published elsewhere with post history import.
Read metrics for a post or an account
Pass a post id and the network, or a team id and the network for account-level metrics. Analytics are included on paid plans.
curl "https://api.siaran.my/api/v1/analytics/post?postId=POST_ID&platformType=INSTAGRAM" \
-H "x-api-key: $SIAR_API_KEY" Import history
Post history import pulls posts that were published outside Siar, optionally with their analytics, so a new customer has a full picture from day one. It runs as a job you can poll, within the import quotas of your plan.
curl -X POST "https://api.siaran.my/api/v1/post-history-import" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{ "teamId": "TEAM_ID", "socialAccountType": "INSTAGRAM", "count": 50, "withAnalytics": true }'
# → { "id": "IMPORT_ID", "status": "PENDING", ... } then poll GET /post-history-import/IMPORT_ID What to expect
Networks report their numbers on their own schedule, and some withhold metrics for a while after publishing. Siar refreshes metrics in the background and keeps each snapshot with its time; you can force a refresh, which is capped per day. X is the exception: X bills every read, so X analytics are only fetched when you force a refresh.
Works with every supported network
Frequently asked questions
Are analytics included in the Free plan?
No. Analytics are part of the paid plans. See the pricing page for the exact table.
Which networks have analytics?
The platform pages list, per network, whether post analytics, account analytics and history import are supported.
Can I get the original payload?
Yes. The /raw endpoints return what the network sent, unmodified.
Keep reading
Your first post isone request away.
The Free plan includes 20 posts and 200 uploads a month across 3 teams. No card needed.