Skip to main content
StatisticsVersion: 2021-07-28

Get Social Media Statistics

POST/social-media-posting/statistics

Retrieve analytics data for multiple social media accounts. Supports custom date ranges for both the current period and a comparison period. If no date ranges are provided, defaults to the last 7 days (excluding today) with comparison to the previous 7 days.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:socialplanner/statistics.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available options2021-07-28
Example:2021-07-28

Query Parameters

locationIdstringrequired

Location ID (also known as Sub-Account ID) for the business location.

Example:ve9EPM428h8vShlRW1KT

Body

profileIdsstring[]

Array of connected social media account IDs to fetch analytics for. Limited to 100 accounts maximum.

Possible values: <= 100

Example:["6673d4f770801753dcafd7b8_SovchenxzWl9R3OFPgsj_9285776684082983366"]
platformsstring[]

Array of social media platforms to filter analytics by. If not provided, all platforms will be included.

Available optionsfacebookinstagramlinkedingooglepinterestyoutubetiktok
Example:["facebook","instagram","linkedin","google","pinterest","youtube","tiktok"]
currentRangeobject

Current date range for analytics. If not provided, defaults to the last 7 days (excluding today) with comparison to the previous 7 days.

Example
{
  "startDate": "2025-01-01T00:00:00.000Z",
  "endDate": "2025-01-07T23:59:59.999Z"
}
prevRangeobject

Comparison date range. If not provided, no comparison will be made.

Example
{
  "startDate": "2024-12-25T00:00:00.000Z",
  "endDate": "2024-12-31T23:59:59.999Z"
}

Response

Successfully retrieved analytics data

resultsobjectrequired

Analytics data grouped by metrics and platforms for the requested accounts and date range.

messagestringrequired

Human-readable status message confirming the analytics were built successfully.

Example:Analytics Built Successfully
traceIdstringrequired

Trace ID for debugging

Example:42fc8dd8-d55b-475f-944f-9efb90d77564