Synup
Create a key
v1Resources/Posts/getGet post analytics

Get post analytics

Returns an engagement analytics rollup — summary totals, a per-platform breakdown, trend series, and top posts — across a client's brand-level platform connections.

get/api/v1/posts/analytics
posts:read
Query parameters
clientIdstringrequired
The client to roll up. Required.
fromstringoptional
Start of the reporting period. Defaults to 30 days ago.
tostringoptional
End of the reporting period. Defaults to now.
Response
dataobjectoptional
summaryobjectoptional
Engagement totals for the current period.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
periodDaysnumberoptional
Length of the reporting period, in days.
prevSummaryobjectoptional
Engagement totals for the immediately prior period of equal length, for delta comparison.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
byPlatformarray of objectoptional
Engagement totals broken down by platform for this period.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
prevByPlatformarray of objectoptional
Engagement totals broken down by platform for the prior period.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
trendobjectoptional
Daily view counts per platform across the period.
datesarray of stringoptional
The dates covered by this trend, as YYYY-MM-DD strings.
seriesarray of objectoptional
One entry per platform.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
valuesarray of numberoptional
One value per date in dates, in the same order.
engagementTrendobjectoptional
Daily views, reactions, shares, comments, and reach per platform across the period.
datesarray of stringoptional
The dates covered by this trend, as YYYY-MM-DD strings.
seriesarray of objectoptional
One entry per platform.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
viewsarray of numberoptional
reactionsarray of numberoptional
sharesarray of numberoptional
commentsarray of numberoptional
reacharray of numberoptional
Daily reach values, in the same order as dates.
postsTrendobjectoptional
Daily post-submission counts per platform across the period.
datesarray of stringoptional
The dates covered by this trend, as YYYY-MM-DD strings.
seriesarray of objectoptional
One entry per platform.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
valuesarray of numberoptional
One value per date in dates, in the same order.
allPostsarray of objectoptional
The individual submissions this rollup is built from, sorted by views.
submissionIdstringoptional
Unique identifier for the platform submission.
platformstringoptional
The platform this row is for.
platformPostIdstringoptional
The platform's own id for the published post, or null.
postLinkstringoptional
Public URL of the published post on this platform, or null.
publishedAtstringoptional
When this submission was published, as an ISO 8601 timestamp, or null.
contentPreviewstringoptional
The post's name, for display.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
totalReachnumberoptional
Total reach for this submission.
engRatenumberoptional
Engagement rate — reactions plus shares plus comments, as a percentage of views — or null if there are no views yet.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/posts/analytics
Your API key
clientId *
from
to
{
  "data": {
    "summary": {
      "totalPosts": 18,
      "totalViews": 5400,
      "totalReactions": 320,
      "totalShares": 44,
      "totalComments": 61,
      "periodDays": 30
    },
    "prevSummary": {
      "totalPosts": 14,
      "totalViews": 4100,
      "totalReactions": 260,
      "totalShares": 30,
      "totalComments": 48
    },
    "byPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 10,
        "totalViews": 3200,
        "totalReactions": 210,
        "totalShares": 30,
        "totalComments": 40
      },
      {
        "platform": "instagram",
        "label": "Instagram",
        "totalPosts": 8,
        "totalViews": 2200,
        "totalReactions": 110,
        "totalShares": 14,
        "totalComments": 21
      }
    ],
    "prevByPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 8,
        "totalViews": 2500,
        "totalReactions": 170,
        "totalShares": 20,
        "totalComments": 32
      }
    ],
    "trend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            4,
            6
          ]
        }
      ]
    },
    "engagementTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "views": [
            180,
            210
          ],
          "reactions": [
            12,
            15
          ],
          "shares": [
            2,
            3
          ],
          "comments": [
            4,
            5
          ],
          "reach": [
            900,
            1100
          ]
        }
      ]
    },
    "postsTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            1,
            2
          ]
        }
      ]
    },
    "allPosts": [
      {
        "submissionId": "cm_sub_xyz789",
        "platform": "facebook",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "publishedAt": "2026-01-16T14:00:00.000Z",
        "contentPreview": "Join us this weekend for our fall special — 20% off all services!",
        "totalViews": 890,
        "totalReactions": 42,
        "totalShares": 6,
        "totalComments": 9,
        "totalReach": 1450,
        "engRate": 0.064
      }
    ]
  }
}