Get post performance
Get post-level numbers for a date range, with a total.
GET https://cotlet.dev/api/v1/sprout-social/post-performance
read
Returns the posts published in the range with their text, network and the performance numbers Sprout reports for each, plus totals over the posts returned. The numbers are what Sprout shows in its post-level reports, so what is available follows your plan. Results are paged.
Parameters
| Name | Type | Description |
|---|---|---|
| profile_ids string[] | string[] | Profile IDs from list_profiles. Leave empty for every profile your login can see. |
| since string required | string | Start date, ISO, for example 2026-10-12. |
| until string required | string | End date, ISO. |
| limit integer | integer | Maximum posts to return. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/sprout-social/post-performance?profile_ids=p_li_02&profile_ids=p_ig_01&profile_ids=p_fb_03&since=2026-10-12&until=2026-10-18&limit=3" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("sprout-social", "get_post_performance", {"profile_ids":["p_li_02","p_ig_01","p_fb_03"],"since":"2026-10-12","until":"2026-10-18","limit":3})const result = await cotlet.call('sprout-social', 'get_post_performance', {"profile_ids":["p_li_02","p_ig_01","p_fb_03"],"since":"2026-10-12","until":"2026-10-18","limit":3});cotlet call sprout-social get_post_performance --data '{"profile_ids":["p_li_02","p_ig_01","p_fb_03"],"since":"2026-10-12","until":"2026-10-18","limit":3}'Example response
{
"posts": [
{
"post_id": "pub_3188",
"profile_id": "p_li_02",
"network": "linkedin",
"text": "Product launch: three new reports.",
"published_at": "2026-10-13T09:00:00+02:00",
"impressions": 9800,
"engagements": 612
},
{
"post_id": "pub_3190",
"profile_id": "p_ig_01",
"network": "instagram",
"text": "Behind the scenes at the studio.",
"published_at": "2026-10-15T10:00:00+02:00",
"impressions": 7100,
"engagements": 480
},
{
"post_id": "pub_3195",
"profile_id": "p_fb_03",
"network": "facebook",
"text": "How Marta cut her reporting time.",
"published_at": "2026-10-16T12:00:00+02:00",
"impressions": 5200,
"engagements": 351
}
],
"totals": {
"impressions": 22100,
"engagements": 1443
},
"next_cursor": null
}