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 |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| 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
- Body
- UsersReponse
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
- Body
- MediaResponse
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.
- User
- UserReponse
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.
- Media List
- GetMyMedia_ResponseV2
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.
- Media List
- OnMyNewMedia_ResponseV2
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. |