Analytics on a Post by Social ID

Get real-time analytics for posts using the Social Post ID

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