ACME API Documentation logo

Analytics on a Post by Social ID

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

POSThttps://api.acme.com/api/analytics/post
Available on Business, Enterprise plans.

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: 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 ACME found in the id field.

  • 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

Authorizationstringrequired
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Keystring
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Body Parameters

idstringrequired

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

platformsarrayrequired

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

Available values:

{
  "platforms": ["facebook", "instagram", "linkedin", "threads",
                "tiktok", "twitter", "youtube"]
}
searchPlatformIdbooleanrequireddefault: false

Set 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.
  */
}