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 /raw variants.
  • 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.