Skip to main content
POST
/
analytics
/
post
{
    // 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.
  */
}

Documentation Index

Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 (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 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.
  • 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.
  • When using postIds for X/Twitter threads, each tweet’s Social Post ID must be provided individually, thread tweets are not automatically included when querying the parent post.

​
Header Parameters

​
Body Parameters

Either id or postIds must be provided. Use id for a single post or postIds for retrieving analytics on multiple posts in a single request.
​
id
string
Social Post ID returned from the /post endpoint. This is the id field for an individual social network found in the postIds array. Either id or postIds is required.
​
postIds
array
Array of Social Post IDs to retrieve analytics for multiple posts in a single request. Maximum of 100 IDs allowed. Either id or postIds is required.
{
  "postIds": ["1979851549871354062", "2011793803951137234"]
}
​
platforms
array
required
String array of platforms to retrieve analytics. Only one value is allowed.Available values:
{
  "platforms": ["facebook", "instagram", "linkedin", "threads",
                "tiktok", "twitter", "youtube"]
}
​
searchPlatformId
boolean
default:false
required
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
}
When cumulative metrics (e.g., likes, comments, views) are temporarily unavailable from the social network, the API automatically backfills them from stored data. Two optional fields may appear in the per-platform analytics object:
  • backfilledFrom (string, ISO 8601) — Present when one or more cumulative metrics were substituted from stored data. The timestamp indicates when the stored data was last updated.
  • recoveredFrom (string, ISO 8601) — Present when the entire analytics response was recovered from stored data due to a complete API failure. The timestamp indicates when the stored data was last updated.
Stored data older than 4 days is considered stale and will not be used for backfill or recovery.
{
  /**
    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.
  */
}