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

Retrieve analytics for posts that did not originate via Ayrshare by providing the low-level Social Post ID. This ID is returned in the postIds field of the /post endpoint.

The linked account must be the owner of the post to retrieve the analytics. Support platforms: Facebook, Instagram, LinkedIn, TikTok, Twitter, and YouTube.

  • The call is the same as the Analytics on a Post endpoint. The key difference is you use the post id return by the social network instead of the Ayrshare ID. Also include the searchPlatformId: true parameter notify the endpoint you’re searching by the Social Post ID.

  • Use the Get All Post History endpoint to retrieve posts and IDs originating outside of Ayrshare found in the id field.

  • Recommend to only use for posts not sent via Ayrshare. For posts sent via Ayrshare, use the analytics endpoint.

  • Analytics on Instagram posts that were published before the user’s account was converted to a business account from a personal account have limited analytics.

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

Social Post ID returned from the /post endpoint. This is the id field for an individual social networks found in the postIds array.

platforms
array
required

String array of platforms to retrieve analytics. Only one value is allowed.

Available values:

{
  "platforms": ["facebook", "instagram", "linkedin",
                "tiktok", "twitter", "youtube"]
}
searchPlatformId
boolean
default: falserequired

Set to true to search by the Social Post ID.