Instagram List

Instagram List

Certified

List Instagram media items

Retrieves recent media for a professional account. Defaults to 25 items, matching the Graph API default.

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

List latest media items

yaml
id: instagram_list_media
namespace: company.team

tasks:
  - id: list_media
    type: io.kestra.plugin.meta.instagram.media.List
    igId: "{{ secret('INSTAGRAM_ACCOUNT_ID') }}"
    accessToken: "{{ secret('INSTAGRAM_ACCESS_TOKEN') }}"
    limit: 25
    fields:
      - ID
      - MEDIA_TYPE
      - MEDIA_URL
      - PERMALINK
      - CAPTION
Installation

Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:

kestractl plugins get io.kestra.plugin:plugin-meta --compatible-for $KESTRA_VERSION

For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.

For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.

Properties

Access Token

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

Instagram Account ID

ID of the Instagram professional account to act on.

Defaultv24.0

API Version

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

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
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.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch strategy

FETCH (default) returns all rows; FETCH_ONE returns the first; STORE writes rows to storage as Ion and returns the URI; NONE only counts items.

SubTypestring
Default["ID","MEDIA_TYPE","MEDIA_URL","PERMALINK","THUMBNAIL_URL","TIMESTAMP","CAPTION"]
Possible Values
IDMEDIA_TYPEMEDIA_URLPERMALINKTHUMBNAIL_URLTIMESTAMPCAPTIONUSERNAMECOMMENTS_COUNTLIKE_COUNTIS_SHARED_TO_FEEDBOOST_ADS_LISTBOOST_ELIGIBILITY_INFOIS_COMMENT_ENABLEDVIEW_COUNT

Fields

Fields to return for each media item (Graph field names).

Defaulthttps://graph.facebook.com

Host URL

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

Default25

Limit

Maximum media items to fetch; defaults to 25.