Skip to content

Analytics

How published posts did, per account and for a group.

3 endpoints

GET/groups/{groupId}/accounts/{accountId}/analytics/posts

Per-post metrics for one account

Any key

The window is clamped to your plan's analytics history.

Path

  • groupIduuidrequired

    A social group id from GET /groups.

  • accountIduuidrequired

    An account id from the group's accounts.

Query

  • limitinteger

    1 to 50, default 20

  • offsetinteger

    0 to 100000, default 0

  • fromdatetime

    Published at or after. Defaults to 30 days ago; clamped to the plan's history.

  • todatetime

    Published before. Defaults to now.

  • metricsstring

    Comma-separated subset of views, likes, comments, shares, saves, reach, impressions.

    up to 200 characters

Returns

200 with these fields; an error answers in the Error envelope.

  • itemsarray of objects
    Show 6 fields
    • target_iduuid
    • post_iduuid
    • platformstring
      xtelegraminstagramfacebooklinkedintiktokyoutube
    • permalinkstring or null
    • published_atdatetime or null
    • metricsmap of number or null
  • countinteger

    -9007199254740991 to 9007199254740991

  • limitinteger

    -9007199254740991 to 9007199254740991

  • offsetinteger

    -9007199254740991 to 9007199254740991

  • nextstring or null
  • previousstring or null
curl https://postacio.com/api/v1/groups/$GROUP_ID/accounts/$ACCOUNT_ID/analytics/posts \
  -H "Authorization: Bearer $POSTACIO_API_KEY"
GET/groups/{groupId}/accounts/{accountId}/analytics/followers

Follower count over time for one account

Any key

Buckets are in the group's timezone; each holds the last reading in it.

Path

  • groupIduuidrequired

    A social group id from GET /groups.

  • accountIduuidrequired

    An account id from the group's accounts.

Query

  • fromdatetime
  • todatetime
  • bucketstring

    default day

    dayweek

Returns

200 with these fields; an error answers in the Error envelope.

  • pointsarray of objects
    Show 2 fields
    • atdatetime
    • followersnumber or null
curl https://postacio.com/api/v1/groups/$GROUP_ID/accounts/$ACCOUNT_ID/analytics/followers \
  -H "Authorization: Bearer $POSTACIO_API_KEY"
GET/groups/{groupId}/analytics/summary

A group's numbers per account and in total

Any key

Posts published in the window, each metric summed over them (each post's latest reading), and the change in followers. The window is clamped to your plan's analytics history.

Path

  • groupIduuidrequired

    A social group id from GET /groups.

Query

  • fromdatetime

    Published at or after. Defaults to 30 days ago; clamped to the plan's history.

  • todatetime

    Published before. Defaults to now.

  • metricsstring

    Comma-separated subset of views, likes, comments, shares, saves, reach, impressions.

    up to 200 characters

Returns

200 with a GroupSummary object; an error answers in the Error envelope.

curl https://postacio.com/api/v1/groups/$GROUP_ID/analytics/summary \
  -H "Authorization: Bearer $POSTACIO_API_KEY"

Ready to send your first draft?

Start your free trial, create a key in Settings, and call the API in a minute.

Start free trialRead the guide