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

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

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

Additional Information

  • The following platforms are currently supported: Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, TikTok, and YouTube.

  • Facebook and Instagram comment counts shown in the API may differ from counts displayed in the social apps. This occurs for two reasons:

    • Some users have privacy settings that hide their comments from non-friends or users without mutual connections. These private comments are still included in the total comment count.
    • There may be inconsistencies in the data reported by Meta.
  • X/Twitter Threads return as an Array of objects, with each object corresponding to a Tweet in the Thread.

  • YouTube can take 24-48 hours to process analytics for videos with few video views or channel followers.

  • For TikTok analytics access, account owners must:

    1. Publish at least one video.
    2. Tap the “Turn On” button on the Analytics page of their mobile TikTok app.
    3. Have 100 followers to receive additional insights about viewers and content engagement.
  • Some TikTok analytics fields may be unavailable if the video has been inactive for more than 7 days. These fields include:

    • reach
    • fullVideoWatchedRate
    • totalTimeWatched
    • averageTimeWatched
    • impressionSources
    • audienceCountries

    To retrieve this data, generate new activity on the video (view, like, comment, or share) and retry after 24-48 hours. 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 analytics are limited to personal pages. LinkedIn Personal Pages only return like, comment, and reaction counts when available.

  • Instagram Story insights are only available for 24 hours, regardless of whether stories are archived or highlighted. Note:

    • Story media metrics with values less than 5 return as 0.
    • For Stories created by users in Europe and Japan, the replies metric returns a value of 0.
  • Facebook Story analytics are not available.
  • Pinterest analytics data (impressions, user followers, and clicks) becomes available after 24-72 hours.

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

id
string
required

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

platforms
array

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

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

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