POST
/
analytics
/
social
Available on Premium, Business, Enterprise plans.

Get analytics and demographics on a user’s social profile, such as impressions, views, and followers.

Currently available for Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, YouTube, Google My Business, TikTok, Reddit, and Pinterest.

  • Facebook Page analytics is only available on Pages with 100 or more likes, such as demographics. Facebook typically updates their metrics once every 24 hours.

  • Instagram may take up to 48 hours to calculate the analytics data. Follower count analytics is not available with fewer than 100 followers. Demographic metrics only return the top 45 performers, only viewers for whom we have demographic data are used in demographic metric calculations, and demographic data is not returned if the Instagram User has fewer than 100 engagements during the last 30 days.

  • LinkedIn only supports Company Page analytics. LinkedIn count totals are eventually consistent, but not immediately consistent, and can take up to 24-48 hours in some cases.

  • Please see the post analytics endpoint for additional info.

​
Header Parameters

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
​
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

​
Body Parameters

​
platforms
array
required

Social media platforms to get analytics. Accepts an array of strings with values:

{
  "platforms": ["bluesky", "instagram", "facebook",
     "linkedin", "pinterest", "reddit", 
     "tiktok", "twitter", "youtube"]
}
​
quarters
integer

Specifies how many quarters of historical data to return. A quarter is:

  • 85 days for Facebook
  • 90 days for Instagram
  • 90 days for YouTube

Only available for Facebook, Instagram, and YouTube platforms.

Valid values: Min = 1, Max = 4

Default values:

  • When daily is false: Default = 4 quarters
  • When daily is true: Default = 1 quarter
​
daily
boolean
default:
false

When set to true, returns analytics data as daily time-series values instead of aggregated totals. This option is only available for Facebook, Instagram, TikTok, and YouTube platforms. Due to the larger data size, using compression is recommended.

​
period60Days
boolean
default:
false

For TikTok analytics, when set to true, this returns only the 60-day aggregate totals for comments, shares, and views (commentCountTotal, shareCountTotal, viewCountTotal). This provides faster response times compared to retrieving the full analytics history. Note: Do not use this parameter together with daily=true as they are incompatible.

Important: As of March 1, 2025, TikTok analytics will only return 60-day totals regardless of this parameter setting. See upcoming changes for details.

Analytics on a Post by Social IDYouTube Playlists