Share via


Instagram Basic Display (Independent Publisher)

The Instagram Basic Display connector allows users of your app to get basic profile information, photos, and videos in their Instagram accounts. The API is intended for non-Business and non-Creator Instagram users.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions
Power Automate Premium All Power Automate regions
Power Apps Premium All Power Apps regions
Contact
Name Reshmee Auckloo
URL https://github.com/reshmee011
Email reshmee011@gmail.com
Connector Metadata
Publisher Reshmee Auckloo
Website https://www.instagram.com
Privacy policy https://privacycenter.instagram.com/policy/?entry_point=ig_help_center_data_policy_redirect
Categories Data

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
accessToken securestring The access token for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get Media Details

Retrieves media details posted by the authenticated user and additional fields like media_type, media_url, caption, permalink and thumbnail_url can be specified.

Get My Details

Retrieves information about the authenticated user. By default it retrieves the Id and other details like username, media_count and account_type can be returned by requesting them via the fields parameter.

Get my Media

Retrieves a list of media items posted by the authenticated user and additional fields like media_type, media_url, caption, permalink,thumbnail_url and timestamp of each item can be specified.

Get Media Details

Retrieves media details posted by the authenticated user and additional fields like media_type, media_url, caption, permalink and thumbnail_url can be specified.

Parameters

Name Key Required Type Description
Media Id
media-id True string

A valid media id of the post.

Fields
fields string

Specify the fields you want returned. Example (caption,media_type,media_url,permalink,timestamp,username,thumbnail_url).

Returns

Name Path Type Description
data
data array of object

data

Media type
data.media_type string

The Media's type. Can be IMAGE, VIDEO, or CAROUSEL_ALBUM.

Media Url
data.media_url string

The Media's URL.

Media permanent URL
data.permalink string

The Media's permanent URL. Will be omitted if the Media contains copyrighted material, or has been flagged for a copyright violation.

Media id
data.id string

The Media's ID.

Username
data.username string

The Media owner's username.

Timestamp
data.timestamp string

ISO 8601 formatted creation date in UTC.

Caption
data.caption string

The Media's caption text. Not returnable for Media in albums.

thumbnail_url
data.thumbnail_url string

The Media's thumbnail image URL. Only available on VIDEO Media.

before
paging.cursors.before string

before

after
paging.cursors.after string

after

Get My Details

Retrieves information about the authenticated user. By default it retrieves the Id and other details like username, media_count and account_type can be returned by requesting them via the fields parameter.

Parameters

Name Key Required Type Description
Fields
fields string

Specify the fields you want returned. Example (id,media_count,username,account_type).

Returns

Name Path Type Description
Username
username string

The User's username.

Media count
media_count integer

The number of Media on the User.

account_type
account_type string

account_type

Media id
id string

The Media's ID.

Get my Media

Retrieves a list of media items posted by the authenticated user and additional fields like media_type, media_url, caption, permalink,thumbnail_url and timestamp of each item can be specified.

Parameters

Name Key Required Type Description
Fields
fields string

Specify the fields you want returned. Example (caption,media_type,media_url,permalink,timestamp,username,thumbnail_url).

Returns

Name Path Type Description
data
data array of object

data

Media type
data.media_type string

The Media's type. Can be IMAGE, VIDEO, or CAROUSEL_ALBUM.

Media Url
data.media_url string

The Media's URL.

Media permanent URL
data.permalink string

The Media's permanent URL. Will be omitted if the Media contains copyrighted material, or has been flagged for a copyright violation.

Media id
data.id string

The Media's ID.

Username
data.username string

The Media owner's username.

Timestamp
data.timestamp string

ISO 8601 formatted creation date in UTC.

Caption
data.caption string

The Media's caption text. Not returnable for Media in albums.

thumbnail_url
data.thumbnail_url string

The Media's thumbnail image URL. Only available on VIDEO Media.

before
paging.cursors.before string

before

after
paging.cursors.after string

after