GetInsights

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

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

yaml
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*string

pageId*string

postIds*array

SubTypestring

apiBaseUrlstring

Defaulthttps://graph.facebook.com

apiVersionstring

Defaultv24.0

datePresetstring

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

metricsarray

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