Analytics on a Post by Social ID
Get real-time analytics for posts using the Social Post ID
Retrieve analytics for posts that did not originate via ACME 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 (exception: YouTube; see below). Support platforms: Facebook, Instagram, LinkedIn, Threads, 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 ACME ID. Also include the
searchPlatformId: trueparameter 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 ACME found in the
idfield.Recommend to only use for posts not sent via ACME. For posts sent via ACME, 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.
If retrieving YouTube analytics for a post that doesn't belong to your channel using the social ID method, the API will return descriptive metadata about the content while showing zeros for all numerical metrics. Descriptive information such as title, description, tags, channel title, privacy status, and thumbnail URLs will be correctly populated, providing context about the video content. However, all numerical performance metrics including views, likes, comments, shares, subscriber changes, watch time, and playlist additions will return as zero values.
Header Parameters
AuthorizationstringrequiredProfile-KeystringBody Parameters
idstringrequiredSocial Post ID returned from the /post
endpoint. This is the id field for an individual social networks found in the
postIds array.
platformsarrayrequiredString array of platforms to retrieve analytics. Only one value is allowed.
Available values:
{
"platforms": ["facebook", "instagram", "linkedin", "threads",
"tiktok", "twitter", "youtube"]
}searchPlatformIdbooleanrequireddefault: falseSet to true to search by the Social Post ID.
{
// Facebook Social Post ID
"id": "104923907983682_108329000309742",
"platforms": [
// Select only one platform at a time:
// facebook, instagram, youtube, threads, tiktok, or twitter
"facebook"
],
"searchPlatformId": true // Required
}{
/**
The response is the same as Analytics on a Post.
Please see that endpoint for details.
Note: Some metrics are not available for posts not owned by the authorized account.
For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
*/
}