POST
/
analytics
/
post

Get real-time analytics such as likes, impressions, views, and reactions for a post that was sent via Ayrshare.

For analytics on posts originating outside of Ayrshare see Analytics by Social ID.

​
Additonal Information

  • Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, TikTok, and YouTube are currently supported.
  • You might need to unlink and re-link Facebook and Instagram in the Dashboard’s Social Accounts Page to grant the new Analytics permissions.
  • Twitter Threads returns as an Array of objects, with each object corresponding to a Tweet in the Thread.
  • YouTube can take up to 24 hours to process analytics for videos with fewer views.
  • TikTok account owners need to first publish at least one video, then tap the “Turn On” button on the Analytics page of their mobile TikTok app. You will receive more insights about your viewers and the content they’ve engaged with once you have 100 followers.
  • If the TikTok fields reach, fullVideoWatchedRate, totalTimeWatched, averageTimeWatched, impressionSources, and audienceCountries are unavailable, the reason is that the video has not had activity on it (comments, likes, views) for more than 7 days. To retrieve the data for these fields, you can view, like, comment, or share the inactive video and retry after 24 ~ 48h. If a video is not returned in the response, the reason is likely to be that the video has been filtered out due to violations, such as music copyright violation.
  • LinkedIn limits the analytics on posts to personal pages. LinkedIn Personal Pages only return like, comment, and reaction counts if available.
  • Instagram Story insights are only available for 24 hours, even if the stories are archived or highlighted. Story media metrics with values less than 5 return as 0. For Stories created by users in Europe and Japan, the replies metric return a value of 0.
  • Facebook Story analytics are not available.
  • Some Pinterest analytics data such as impressions, user followers, and click are available after 24-72 hours.
Available on Basic and Premium plans.

​
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

id
string
required

Ayrshare Post ID returned from the /post endpoint. This is the top level Ayrshare id returned and not the social ids in postIds.

platforms
array

String array of platforms to retrieve analytics. Accepts an array of strings with values:

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

If platforms is not included, all the analytics on all of the social networks the post to which the was sent will be returned.

Analytics API OverviewAnalytics on a Post by Social ID