List

List Instagram media items

Retrieve a list of the latest media items from an Instagram professional account

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

Examples

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

accessToken *string

Access Token

Instagram access token with appropriate permissions (instagram_basic, instagram_content_publish, etc.)

igId *string

Instagram Account ID

The ID of the Instagram professional account

apiVersion string

Default v24.0

API Version

Instagram Graph API version to use

fetchType string

Default FETCH

Possible Values

STOREFETCHFETCH_ONENONE

The way you want to store the data.

FETCH_ONE output the first row, FETCH output all rows, STORE store all rows in a file, NONE do nothing.

fields array

SubType string

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

List of fields to retrieve for each media item

host string

Default https://graph.facebook.com

Host URL

The host URL for the Instagram Graph API

limit integerstring

Default 25

Limit

Maximum number of media items to retrieve

​List

List