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

Retrieve analytics for posts that did not originate via Ayrshare by providing the low-level social 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 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 ID from /post endpoint contained in postIds.

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 ID.