Meta GetInsights

Meta GetInsights
Certified
Collect Instagram media insights

Retrieves insight metrics such as reach, saves, likes, and comments for a specific media item using the Graph API.

yaml
type: io.kestra.plugin.meta.instagram.media.GetInsights

Examples

Get media insights

yaml
id: instagram_get_media_insights
namespace: company.team

tasks:
  - id: get_insights
    type: io.kestra.plugin.meta.instagram.media.GetInsights
    igId: "{{ secret('INSTAGRAM_ACCOUNT_ID') }}"
    accessToken: "{{ secret('INSTAGRAM_ACCESS_TOKEN') }}"
    mediaId: "17954170374002653"
    metrics:
      - LIKES
      - COMMENTS
      - SAVES
      - REACH

Properties

accessToken *string

Access Token

Access token with required scopes (e.g., instagram_basic, instagram_content_publish).

igId *string

Instagram Account ID

ID of the Instagram professional account to act on.

mediaId *string

Media ID

Instagram media ID to query insights for.

apiVersion string

Defaultv24.0

API Version

Instagram Graph API version to call. Defaults to v24.0.

host string

Defaulthttps://graph.facebook.com

Host URL

Base Graph API URL. Defaults to https://graph.facebook.com.

metrics array

SubTypestring

Default["LIKES","COMMENTS","SAVES","REACH"]

Possible Values

LIKESCOMMENTSSAVESSHARESREACHIMPRESSIONSPROFILE_VISITSPROFILE_ACTIVITYWEBSITE_CLICKSEMAIL_CONTACTSPHONE_CALL_CLICKSTEXT_MESSAGE_CLICKSGET_DIRECTIONS_CLICKSFOLLOWSUNFOLLOWSVIEWSTOTAL_INTERACTIONSREPLIESTAPS_FORWARDTAPS_BACKEXITSNAVIGATION

Metrics

Insight metrics to fetch; defaults to likes, comments, saves, and reach.