get_post_analytics
Retrieve analytics metrics for published social media posts, including impressions, reactions, engagements, clicks, shares, comments, and video views over specified time periods.
Instructions
Get analytics metrics for individual published posts.
Post-level metrics use the 'lifetime.' prefix (e.g. 'lifetime.impressions').
Common metrics: lifetime.impressions, lifetime.reactions, lifetime.engagements,
lifetime.clicks, lifetime.shares, lifetime.comments, lifetime.video_views.
Args:
profile_ids: Comma-separated Sprout profile IDs.
start_time: Start of period (ISO 8601, e.g. '2024-01-01T00:00:00').
end_time: End of period (ISO 8601, e.g. '2024-01-31T23:59:59').
metrics: Comma-separated metric names with lifetime. prefix.
limit: Number of posts to return (default 50, max 100).
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile_ids | Yes | ||
| start_time | Yes | ||
| end_time | Yes | ||
| metrics | No | lifetime.impressions,lifetime.reactions,lifetime.engagements,lifetime.clicks | |
| limit | No | ||
| customer_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |