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.

assets

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions

io.kestra.core.models.assets.AssetsDeclaration

assetFailureBehaviorstring

Possible Values

IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

io.kestra.core.models.assets.AssetIdentifier

id*string

Min length1

typestring

outputs

The assets produced as outputs.

io.kestra.plugin.ee.assets.Dataset

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.plugin.ee.assets.File

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.plugin.ee.assets.Table

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.plugin.ee.assets.VM

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.core.models.assets.External

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.core.models.assets.Custom

id*string

Min length1

Max length150

type*string

Min length1

Custom asset type

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

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.