Instagram

Instagram

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

Throttling Limits

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

Actions

Get comments for media

This operation returns a list of comments on a media object.

Required Parameters

Media Id
string
Specify the media to fetch the comments.

Returns

Comments
CommentsResponse

List of comments.

Get likes for media [DEPRECATED]

Gets the list of users who have liked a media object

Required Parameters

Media id
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.

Required Parameters

Media Shortcode
string
The media shortcode to fetch the media by.

Returns

Media Item
MediaItem

Properties of a single media item.

Get media info [DEPRECATED]

This operation returns information about a media.

Required Parameters

Media Id
string
The ID of the media to fetch.

Returns

Get my profile

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

Required Parameters

Media Id
string
Specify the media to fetch the comments.

Returns

User
UserReponse

Details of a single user.

Get my recent media

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

Optional Parameters

Max Count
double
Limit on the number of media objects to be retrieved (default, max = 100).
Max Id
string
Return media earlier than this max Id.
Min Id
string
Return media earlier than this min Id

Returns

Media List
MediasResponse

List of newly posted media content.

Triggers

When I upload a new media

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

Returns

Media List
MediasResponse

List of newly posted media content.

Definitions

UserReponse

Details of a single user.

User
DetailedUserItem
Details of a single user.

UsersReponse

Users
array of DetailedUserItem
The List of users returned.

MediaResponse

Media Item
MediaItem
Properties of a single media item.

MediasResponse

List of newly posted media content.

Media
array of MediaItem
The list of media items returned.

CommentsResponse

List of comments.

Comments
array of CommentItem
The List of comment objects returned

UserItem

First name
string
First name of the user.
Full name of the user
string
Full name of the user.
Last name
string
Last name of the user.
Profile picture
string
Profile picture of the user.
User id
string
Instagram ID of the user.
Username
string
Username of the user.

DetailedUserItem

Details of a single user.

Bio
string
Bio of the user.
Id
string
Unique identifier of the user.
Instagram
uri
Url of the User's instagram Page.
Name
string
Full name of the user.
Picture
string
Profile picture of the User.
Username
string
Username of the User.
counts
CountsItem
Details of a single user.

CountsItem

Followed-by Count
integer
Number of user who has followed the user.
Following count
integer
Following count for the User.
Media count
integer
Media count for the User.

CommentItem

Properties of a single comment.

Id
string
The unique ID for the comment.
Text
string
The text commented.
from
UserItem
Properties of a single comment.

TagItem

Name of the tag.
string
Name of the tag.
Number of media items with the tag.
integer
Number of media items with the tag.

MediaItem

Properties of a single media item.

Filtered media
string
Filtered media.
Media id
string
Unique ID for the media.
Media link
uri
Link to the media.
Tags put on the media
array of TagItem
Tags put on the media.
caption
CaptionItem
Properties of a single media item.
images
ResolutionItem
Properties of a single media item.
user
UserItem
Properties of a single media item.

ResolutionItem

standard_resolution
ImageItem

ImageItem

Image height
integer
The height of an image on the media in set resolution.
Image uri
uri
The url to an image on the media in set resolution.
Image width
integer
The width of an image on the media in set resolution.

CaptionItem

Caption text
string
Caption text on the media.