Meta List

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

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.

Reference (ref) of the pluginDefaults to apply to this task.