Share via


Instagram [DEPRECATED]

Instagram is an online service for sharing pictures with friends and family. Connect to Instagram API to read photo streams on your Instagram account.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Connector Metadata
Publisher Microsoft
Website https://www.instagram.com/
Privacy policy https://help.instagram.com/519522125107875

Deprecation Information

The Instagram connector has been deprecated as of July 2020 due to the disabling of Instagram's Legacy API. We have replaced this with an open source example which users can extend and deploy as a custom connector for their purposes.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 60 seconds

Actions

Get comments for media [DEPRECATED]

This operation returns a list of comments on a media object. It will return latest 150 comments.

Get likes for media [DEPRECATED]

Gets the list of users who have liked a media object

Get media by shortcode [DEPRECATED]

This operation retrieves information about a media through a short code. A media object's shortcode can be found in its shortlink URL. An example shortlink is http://instagram.com/p/tsxp1hhQTG/. Its corresponding shortcode is tsxp1hhQTG.

Get media info [DEPRECATED]

This operation returns information about a media.

Get my profile [DEPRECATED]

This operation returns detailed information about a User.

Get my profile [DEPRECATED]

This operation returns detailed information about a User based on a username.

Get my recent media [DEPRECATED]

This operation returns recent media posted by the logged in user.

Get my recent media [DEPRECATED]

This operation returns recent media posted by the logged in user.

Get comments for media [DEPRECATED]

This operation returns a list of comments on a media object. It will return latest 150 comments.

Parameters

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

Specify the media to fetch the comments.

Returns

List of comments.

Comments
CommentsResponse

Get likes for media [DEPRECATED]

Gets the list of users who have liked a media object

Parameters

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

Specify the media ID to fetch the likes

Returns

Get media by shortcode [DEPRECATED]

This operation retrieves information about a media through a short code. A media object's shortcode can be found in its shortlink URL. An example shortlink is http://instagram.com/p/tsxp1hhQTG/. Its corresponding shortcode is tsxp1hhQTG.

Parameters

Name Key Required Type Description
Media Shortcode
shortcode True string

The media shortcode to fetch the media by.

Returns

Properties of a single media item.

Media Item
MediaItem

Get media info [DEPRECATED]

This operation returns information about a media.

Parameters

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

The ID of the media to fetch.

Returns

Get my profile [DEPRECATED]

This operation returns detailed information about a User.

Parameters

Name Key Required Type Description
Select Query
fields string

A comma-separated list of fields you want returned. If omitted, default fields will be returned.

Returns

Properties of a User.

User information
User

Get my profile [DEPRECATED]

This operation returns detailed information about a User based on a username.

Returns

Details of a single user.

Get my recent media [DEPRECATED]

This operation returns recent media posted by the logged in user.

Parameters

Name Key Required Type Description
Select Query
fields string

A comma-separated list of fields you want returned. If omitted, default fields will be returned.

Returns

List of media content.

Get my recent media [DEPRECATED]

This operation returns recent media posted by the logged in user.

Parameters

Name Key Required Type Description
Max Count
count double

Limit on the number of media objects to be retrieved (default, max = 100).

Max Id
max_id string

Return media earlier than this max Id.

Min Id
min_id string

Return media earlier than this min Id

Returns

List of newly posted media content.

Media List
MediasResponse

Triggers

When I upload a new media [DEPRECATED]

This operation is triggered when a new media is posted to my feed.

When I upload a new media [DEPRECATED]

This operation is triggered when a new media is posted to my feed.

When I upload a new media [DEPRECATED]

This operation is triggered when a new media is posted to my feed.

Returns

List of media content.

When I upload a new media [DEPRECATED]

This operation is triggered when a new media is posted to my feed.

Returns

List of newly posted media content.

Media List
MediasResponse

Definitions

User

Properties of a User.

Name Path Type Description
Account type
account_type string

The User's account type. Can be BUSINESS, MEDIA_CREATOR, or PERSONAL.

User id
id string

The User's ID.

Legacy API user id
ig_id string

The User's Instagram Legacy API User ID. This field will be deprecated on September 30th, 2020.

Media count
media_count integer

The number of Media on the User.

Username
username string

The User's username.

Media

Properties of a single media item.

Name Path Type Description
Media id
id string

The Media's ID.

Media caption
caption string

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

Media type
media_type string

The Media's type.

Media URL
media_url uri

The Media's URL.

Media permanent URL
permalink uri

The Media's permanent URL.

Media thumbnail image URL
thumbnail_url uri

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

Timestamp
timestamp date-time

The Media's publish date in ISO 8601 format.

Username
username string

The Media owner's username.

GetMyMedia_ResponseV2

List of media content.

Name Path Type Description
Media
data array of Media

The list of media items returned.

OnMyNewMedia_ResponseV2

List of media content.

Name Path Type Description
data
data array of Media

The list of media items returned.

UserReponse

Details of a single user.

Name Path Type Description
User
data DetailedUserItem

Details of a single user.

UsersReponse

Name Path Type Description
Users
data array of DetailedUserItem

The List of users returned.

MediaResponse

Name Path Type Description
Media Item
data MediaItem

Properties of a single media item.

MediasResponse

List of newly posted media content.

Name Path Type Description
Media
data array of MediaItem

The list of media items returned.

CommentsResponse

List of comments.

Name Path Type Description
Comments
data array of CommentItem

The List of comment objects returned

UserItem

Name Path Type Description
Username
username string

Username of the user.

Profile picture
profile_picture string

Profile picture of the user.

First name
first_name string

First name of the user.

Last name
last_name string

Last name of the user.

Full name of the user
full_name string

Full name of the user.

User id
id string

Instagram ID of the user.

DetailedUserItem

Details of a single user.

Name Path Type Description
Username
username string

Username of the User.

Picture
profile_picture string

Profile picture of the User.

Name
full_name string

Full name of the user.

counts
counts CountsItem
Instagram
website uri

Url of the User's instagram Page.

Bio
bio string

Bio of the user.

Id
id string

Unique identifier of the user.

CountsItem

Name Path Type Description
Media count
media integer

Media count for the User.

Following count
follows integer

Following count for the User.

Followed-by Count
followed_by integer

Number of user who has followed the user.

CommentItem

Properties of a single comment.

Name Path Type Description
Text
text string

The text commented.

Id
id string

The unique ID for the comment.

from
from UserItem

MediaItem

Properties of a single media item.

Name Path Type Description
images
images ResolutionItem
user
user UserItem
Media link
link uri

Link to the media.

Media id
id string

Unique ID for the media.

caption
caption CaptionItem
Tags put on the media
tags array of string

Tags put on the media.

Filtered media
filter string

Filtered media.

ResolutionItem

Name Path Type Description
standard_resolution
standard_resolution ImageItem

ImageItem

Name Path Type Description
Image uri
url uri

The url to an image on the media in set resolution.

Image height
height integer

The height of an image on the media in set resolution.

Image width
width integer

The width of an image on the media in set resolution.

CaptionItem

Name Path Type Description
Caption text
text string

Caption text on the media.