GetInsights

GetInsights
Certified
Collect Facebook post insights

yaml
type: io.kestra.plugin.meta.facebook.posts.GetInsights

Examples

yaml
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"

yaml
id: facebook_post_insights
namespace: company.team

tasks:
  - 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"

yaml
id: facebook_post_insights_preset
namespace: company.team

tasks:
  - 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"

yaml
id: facebook_post_insights_range
namespace: company.team

tasks:
  - 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 *string

pageId *string

postIds *array

SubTypestring

apiBaseUrl string

Defaulthttps://graph.facebook.com

apiVersion string

Defaultv24.0

datePreset string

DefaultTODAY

Possible Values

TODAYYESTERDAYTHIS_MONTHLAST_MONTHTHIS_QUARTERMAXIMUMLAST_3DLAST_7DLAST_14DLAST_28DLAST_30DLAST_90DLAST_WEEK_MON_SUNLAST_WEEK_SUN_SATLAST_QUARTERLAST_YEARTHIS_WEEK_MON_TODAYTHIS_WEEK_SUN_TODAYTHIS_YEAR

metrics array

SubTypestring

Default

["POST_REACTIONS_LIKE_TOTAL","POST_REACTIONS_LOVE_TOTAL","POST_REACTIONS_WOW_TOTAL","POST_REACTIONS_HAHA_TOTAL","POST_REACTIONS_SORRY_TOTAL","POST_REACTIONS_ANGER_TOTAL"]

Possible Values

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_TOTAL