GetInsights
Get insights for Facebook posts
Fetch insights and metrics like reach, impressions, and reactions for one or more Facebook posts
type: "io.kestra.plugin.meta.facebook.posts.GetInsights"Examples
Get default reaction insights for posts
id: facebook_get_post_insights
namespace: company.team
tasks:
- id: get_insights
type: io.kestra.plugin.meta.facebook.posts.GetInsights
pageId: "{{ secret('FACEBOOK_PAGE_ID') }}"
accessToken: "{{ secret('FACEBOOK_ACCESS_TOKEN') }}"
postIds:
- "123456789_987654321"
- "123456789_987654322"
Add custom metrics to default reactions
id: "getinsights"
type: "io.kestra.plugin.meta.facebook.posts.GetInsights"
- id: get_insights_with_custom_metrics
type: io.kestra.plugin.meta.facebook.posts.GetInsights
pageId: "{{ secret('FACEBOOK_PAGE_ID') }}"
accessToken: "{{ secret('FACEBOOK_ACCESS_TOKEN') }}"
postIds:
- "123456789_987654321"
metrics:
- POST_REACTIONS_LIKE_TOTAL
- POST_REACTIONS_LOVE_TOTAL
- POST_REACTIONS_WOW_TOTAL
- POST_REACTIONS_HAHA_TOTAL
- POST_REACTIONS_SORRY_TOTAL
- POST_REACTIONS_ANGER_TOTAL
- POST_IMPRESSIONS
- POST_ENGAGED_USERS
period: "lifetime"
Get insights with date preset
id: "getinsights"
type: "io.kestra.plugin.meta.facebook.posts.GetInsights"
- id: get_insights_last_7_days
type: io.kestra.plugin.meta.facebook.posts.GetInsights
pageId: "{{ secret('FACEBOOK_PAGE_ID') }}"
accessToken: "{{ secret('FACEBOOK_ACCESS_TOKEN') }}"
postIds:
- "123456789_987654321"
datePreset: "last_7d"
period: "day"
Get insights with custom date range
id: "getinsights"
type: "io.kestra.plugin.meta.facebook.posts.GetInsights"
- id: get_insights_custom_range
type: io.kestra.plugin.meta.facebook.posts.GetInsights
pageId: "{{ secret('FACEBOOK_PAGE_ID') }}"
accessToken: "{{ secret('FACEBOOK_ACCESS_TOKEN') }}"
postIds:
- "123456789_987654321"
since: "2025-10-01"
until: "2025-10-15"
period: "day"
Properties
accessToken*Requiredstring
Access Token
Facebook Page access token with appropriate permissions (pages_manage_posts, pages_manage_engagement, etc.)
pageId*Requiredstring
Facebook Page ID
The ID of the Facebook page to perform operations on
postIds*Requiredarray
Post IDs
List of Facebook post IDs to get insights for (format: pageId_postId)
apiBaseUrlstring
https://graph.facebook.comBase API URL
The base URL for the Facebook Graph API
apiVersionstring
v24.0API Version
Facebook Graph API version to use
datePresetstring
TODAYTODAYYESTERDAYTHIS_MONTHLAST_MONTHTHIS_QUARTERMAXIMUMLAST_3DLAST_7DLAST_14DLAST_28DLAST_30DLAST_90DLAST_WEEK_MON_SUNLAST_WEEK_SUN_SATLAST_QUARTERLAST_YEARTHIS_WEEK_MON_TODAYTHIS_WEEK_SUN_TODAYTHIS_YEARDate Preset
Preset a date range, like last_week, yesterday. If since or until are present, date_preset is ignored.
metricsarray
["POST_REACTIONS_LIKE_TOTAL","POST_REACTIONS_LOVE_TOTAL","POST_REACTIONS_WOW_TOTAL","POST_REACTIONS_HAHA_TOTAL","POST_REACTIONS_SORRY_TOTAL","POST_REACTIONS_ANGER_TOTAL"]POST_REACTIONS_LIKE_TOTALPOST_REACTIONS_LOVE_TOTALPOST_REACTIONS_WOW_TOTALPOST_REACTIONS_HAHA_TOTALPOST_REACTIONS_SORRY_TOTALPOST_REACTIONS_ANGER_TOTALPOST_IMPRESSIONSPOST_ENGAGED_USERSPOST_CLICKSPOST_REACTIONS_BY_TYPE_TOTALMetrics
List of specific metrics to retrieve. Default includes reaction metrics (like, love, wow, haha, sorry, anger). You can add more metrics like POST_IMPRESSIONS, POST_ENGAGED_USERS, etc.
periodstring
LIFETIMEDAYWEEKDAYS_28MONTHLIFETIMETOTAL_OVER_RANGEPeriod
The aggregation period for insights
sincestring
2026-01-08Since
Lower bound of the time range to consider (datetime). If provided, date_preset does not work.
untilstring
2026-01-08Until
Upper bound of the time range to consider (datetime). If provided, date_preset does not work.
