POST
/
analytics
/
social

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

Currently available for Facebook Pages, Instagram Accounts, Twitter handles, LinkedIn Company Pages, YouTube Channels, Google My Business accounts, TikTok accounts, Reddit, and Pinterest Users.

  • 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
Format: Authorization: Bearer API_KEY. See API overview for more information.
Profile-Key
string
Profile Key of a user profile.

Body Parameters

platforms
array
required

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

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

Number of quarters (90 day period for YouTube, 85 day period for Facebook) of data to return. Min value: 1, Max value 4. Only available for Facebook, Instagram, and YouTube. Default value is 4 if daily is false. Default value is 1 if daily is true.

daily
boolean

Return the daily values when available. Useful for time series. Only available for Facebook, Instagram, and YouTube. Compression recommended.