get_post_performance
Retrieve per-post analytics for posts created in a specific datetime range. Supports custom metrics (e.g., impressions, reactions) and fields (tags, links) for in-depth analysis.
Instructions
Pull post-level analytics for posts created in a datetime range.
Args:
profile_ids: customer_profile_id values from list_profiles. Max 100.
start_datetime: inclusive, YYYY-MM-DDTHH:MM:SS (e.g. 2026-06-01T00:00:00).
end_datetime: inclusive, YYYY-MM-DDTHH:MM:SS (e.g. 2026-06-30T23:59:59).
metrics: post metric keys, mostly prefixed lifetime. -- e.g.
["lifetime.impressions", "lifetime.reactions", "lifetime.comments_count"].
A few are unprefixed (e.g. video_length on Facebook and TikTok).
Network-specific; call list_metrics for valid keys.
fields: post attributes to include, e.g. ["created_time", "text",
"perma_link", "post_type", "internal.tags.id", "internal.sent_by.email"].
timezone: ICANN tz name for bucketing, e.g. "America/Los_Angeles".
sort: sort expressions, e.g. ["lifetime.impressions:desc"].
page: 1-based page to start from (50 posts per page by default).
all_pages: follow pagination and concatenate the data arrays.
max_pages: cap on pages fetched when all_pages is true.
Returns the API response verbatim -- one record per post, carrying whichever fields and metrics were requested. Useful for per-post label/tag analysis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| sort | No | ||
| fields | No | ||
| metrics | No | ||
| timezone | No | ||
| all_pages | No | ||
| max_pages | No | ||
| profile_ids | Yes | ||
| end_datetime | Yes | ||
| start_datetime | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |