When managing social media integrations, tracking the performance of content is just as important as publishing it. Post for Me provides a unified way to retrieve comprehensive analytics across supported platforms through the Social Account Feed.
Here is a breakdown of how to configure your connections and retrieve metrics for your users' posts.
The Social Account Feed
Analytics data is not housed in a separate "analytics" endpoint; instead, it is integrated directly into the Social Account Feed endpoint.
How it works
This endpoint allows you to fetch the feed for any connected social account. This will include every post on that account, regardless of whether it was published through the Post for Me API or natively through the social platform. When enabled, the response includes detailed metrics such as views, likes, shares, and follows, alongside standard post information like captions and media URLs,.
Connection Requirements
To access feed data and metrics, you must ensure the social account is connected with the correct permissions. When generating an authentication URL using the create-upload-url flow (specifically the /v1/social-accounts/auth-url endpoint), you must explicitly request the "feeds" permission in the permissions array.
Note: If an account is connected with only the default "posts" permission, requests to the feed endpoint will not return data,.
Retrieving Metrics
Once an account is connected with the proper permissions, retrieving analytics is a single API call.
Make a GET request to the /v1/social-account-feeds/{social_account_id} endpoint. To include analytics data in the response, you must pass the optional expand parameter with the value metrics.
Example Call:GET /v1/social-account-feeds/spc_12345?expand=metrics
Understanding the Data
The metrics returned by the API represent the current lifetime value of the metric for that specific post.
Platform Specifics
The specific data points returned depend heavily on the platform's API capabilities. For example:
Detailed Metrics: Platforms like TikTok and Facebook provide extensive details, including total time watched, engagement rates, and impression sources,.
Standard Metrics: Instagram and X (Twitter) provide standard counts for likes, comments, views, and shares,.
Limitations: Some platforms, such as LinkedIn, only allow analytics for Company Pages (metrics for personal pages are currently unavailable). Similarly, Bluesky does not currently expose view counts through their API.
For a complete list of available metrics per platform, please refer to the specific response objects in the documentation