Description of Instagram RESTful API.
Current limitations:
POST
, DELETE
) require additional security scopes
that are available for Apps created on or after Nov 17, 2015 and
started in Sandbox Mode.Warning: For Apps created on or after Nov 17, 2015 API responses
containing media objects no longer return the data
field in comments
and likes
nodes.
Last update: 2015-11-28
Manage comments
Remove a comment either on the authenticated user's media object or authored by the authenticated user.
Name | Data Type | Description |
---|---|---|
comment-id
|
string |
The ID of the comment entry. |
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
StatusResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
Get a list of recent comments on a media object.
Name | Data Type | Description |
---|---|---|
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
CommentsResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
data
|
array [CommentEntry] |
Collection of comments |
|||||||||||||||||||||||||||||||||||
Properties
|
Create a comment on a media object with the following rules:
Name | Data Type | Description |
---|---|---|
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
text
|
string |
Text to post as a comment on the media object as specified in |
Name | Data Type | Description |
---|---|---|
StatusResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
Get geographies
Get recent media from a geography subscription that you created.
Note: You can only access Geographies that were explicitly created by your OAuth client. Check the
Geography Subscriptions section of the real-time updates page.
When you create a subscription to some geography that you define, you will be returned a unique geo-id
that
can be used in this query. To backfill photos from the location covered by this geography, use the
media search endpoint.
Warning: Deprecated for Apps created on or after Nov 17, 2015
Name | Data Type | Description |
---|---|---|
geo-id
|
string |
The geography ID. |
Name | Data Type | Description |
---|---|---|
min_id
|
string |
Return media before this |
count
|
integer |
Max number of media to return. |
Name | Data Type | Description |
---|---|---|
MediaListResponse
|
object |
pagination
|
IdPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Manage likes
Remove a like on this media by the currently authenticated user.
Name | Data Type | Description |
---|---|---|
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
StatusResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
Get a list of users who have liked this media.
Name | Data Type | Description |
---|---|---|
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
UsersInfoResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
User short information entries |
||||||||||||||||
Properties
|
Set a like on this media by the currently authenticated user.
Name | Data Type | Description |
---|---|---|
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
StatusResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
Get information about locations
Search for a location by geographic coordinate.
Name | Data Type | Description |
---|---|---|
foursquare_v2_id
|
string |
Returns a location mapped off of a foursquare v2 api location id. If used, you are not required to use
|
lng
|
double |
Longitude of the center search coordinate. If used, |
lat
|
double |
Latitude of the center search coordinate. If used, |
foursquare_id
|
string |
Returns a location mapped off of a foursquare v1 api location id. If used, you are not required to use
|
facebook_places_id
|
string |
Returns a location mapped off of a Facebook places id. If used, a Foursquare id and |
distance
|
integer |
Default is 1000m (distance=1000), max distance is 5000. |
Name | Data Type | Description |
---|---|---|
LocationSearchResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [LocationInfo] |
List of found locations |
||||||||||||||||
Properties
|
Get a list of recent media objects from a given location.
Name | Data Type | Description |
---|---|---|
location-id
|
string |
The location ID. |
Name | Data Type | Description |
---|---|---|
max_id
|
string |
Return media after this |
min_id
|
string |
Return media before this |
max_timestamp
|
long |
Return media before this UNIX timestamp. |
min_timestamp
|
long |
Return media after this UNIX timestamp. |
Name | Data Type | Description |
---|---|---|
MediaListResponse
|
object |
pagination
|
IdPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get information about a location.
Name | Data Type | Description |
---|---|---|
location-id
|
string |
The location ID. |
Name | Data Type | Description |
---|---|---|
LocationInfoResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
LocationInfo |
Location brief information |
||||||||||||||||
Properties
|
Get information about media
Get a list of what media is most popular at the moment. Can return mix of image
and video
types.
Warning: Deprecated for Apps created on or after Nov 17, 2015
Name | Data Type | Description |
---|---|---|
MediaSearchResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
Found media entries; some end-points do not return likes informtaion |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Search for media in a given area. The default time span is set to 5 days. The time span must not exceed 7 days.
Defaults time stamps cover the last 5 days. Can return mix of image
and video
types.
Name | Data Type | Description |
---|---|---|
distance
|
integer |
Default is 1km (distance=1000), max distance is 5km. |
max_timestamp
|
long |
A unix timestamp. All media returned will be taken earlier than this timestamp. |
min_timestamp
|
long |
A unix timestamp. All media returned will be taken later than this timestamp. |
lng
|
double |
Longitude of the center search coordinate. If used, |
lat
|
double |
Latitude of the center search coordinate. If used, |
Name | Data Type | Description |
---|---|---|
MediaSearchResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
Found media entries; some end-points do not return likes informtaion |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
This endpoint returns the same response as GET /media/{media-id}
.
A media object's shortcode can be found in its shortlink URL. An example shortlink is
http://instagram.com/p/D/
, its corresponding shortcode is D
.
Name | Data Type | Description |
---|---|---|
shortcode
|
string |
The short code of the media resource. |
Name | Data Type | Description |
---|---|---|
MediaEntryResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
MediaEntry |
Media resource information |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get information about a media object. The returned type key will allow you to differentiate between image and video media.
Note: if you authenticate with an OAuth Token, you will receive the user_has_liked key which quickly tells you whether the current user has liked this media item.
Name | Data Type | Description |
---|---|---|
media-id
|
string |
The ID of the media resource. |
Name | Data Type | Description |
---|---|---|
MediaEntryResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
MediaEntry |
Media resource information |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Relationships to other users outgoing and incoming
List the users who have requested this user's permission to follow.
Name | Data Type | Description |
---|---|---|
UsersInfoResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
User short information entries |
||||||||||||||||
Properties
|
Get the list of users this user is followed by. To get users followed by the owner of the access token, you
can use self instead of the user-id
.
Name | Data Type | Description |
---|---|---|
user-id
|
string |
The ID of a user, or self to retrieve information about authenticated user. |
Name | Data Type | Description |
---|---|---|
UsersPagingResponse
|
object |
pagination
|
CursorPaginationInfo |
Information for pagination |
||||||||||||||||
Properties
|
||||||||||||||||||
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
List of user short information entries |
||||||||||||||||
Properties
|
Get the list of users this user follows. To get follows of the owner of the access token, you can use self
instead of the user-id
.
Name | Data Type | Description |
---|---|---|
user-id
|
string |
The ID of a user, or self to retrieve information about authenticated user. |
Name | Data Type | Description |
---|---|---|
UsersPagingResponse
|
object |
pagination
|
CursorPaginationInfo |
Information for pagination |
||||||||||||||||
Properties
|
||||||||||||||||||
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
List of user short information entries |
||||||||||||||||
Properties
|
Get information about a relationship to another user.
Name | Data Type | Description |
---|---|---|
user-id
|
string |
The ID of a user to get information about. |
Name | Data Type | Description |
---|---|---|
RelationshipResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||
Properties
|
|||||||||||||||
data
|
RelationshipInfo |
Relationship information |
|||||||||||||
Properties
|
Modify the relationship between the current user and the target user.
Name | Data Type | Description |
---|---|---|
user-id
|
string |
The ID of the target user. |
Name | Data Type | Description |
---|---|---|
action
|
string Allowed values: - follow - unfollow - block - unblock - approve - ignore |
Type of action to apply for relationship with the user. |
Name | Data Type | Description |
---|---|---|
RelationshipPostResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
RelationshipStatus |
Current relationship status |
|||||||
Properties
|
Get information about tags
Search for tags by name.
Name | Data Type | Description |
---|---|---|
q
|
string |
A valid tag name without a leading #. (eg. snowy, nofilter) |
Name | Data Type | Description |
---|---|---|
TagSearchResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||
Properties
|
||||||||||||
data
|
array [TagInfo] |
List of found tags with brief statistics |
||||||||||
Properties
|
Get a list of recently tagged media. Use the max_tag_id
and min_tag_id
parameters in the pagination
response to paginate through these objects.
Name | Data Type | Description |
---|---|---|
tag-name
|
string |
The tag name. |
Name | Data Type | Description |
---|---|---|
max_tag_id
|
string |
Return media after this |
min_tag_id
|
string |
Return media before this |
count
|
integer |
Count of tagged media to return. |
Name | Data Type | Description |
---|---|---|
TagMediaListResponse
|
object |
pagination
|
TagPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries with this tag |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get information about a tag object.
Name | Data Type | Description |
---|---|---|
tag-name
|
string |
The tag name. |
Name | Data Type | Description |
---|---|---|
TagInfoResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||
Properties
|
||||||||||||
data
|
TagInfo |
Tag brief information |
||||||||||
Properties
|
Get information about users
Search for a user by name.
Name | Data Type | Description |
---|---|---|
count
|
integer |
Number of users to return. |
q
|
string |
A query string. |
Name | Data Type | Description |
---|---|---|
UsersInfoResponse
|
object |
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
User short information entries |
||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
max_id
|
string |
Return media earlier than this |
min_id
|
string |
Return media later than this |
count
|
integer |
Count of media to return. |
Name | Data Type | Description |
---|---|---|
MediaListResponse
|
object |
pagination
|
IdPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
See the list of media liked by the authenticated user. Private media is returned as long as the authenticated user has permission to view that media. Liked media lists are only available for the currently authenticated user.
Name | Data Type | Description |
---|---|---|
max_like_id
|
string |
Return media liked before this id. |
count
|
integer |
Count of media to return. |
Name | Data Type | Description |
---|---|---|
MediaListResponse
|
object |
pagination
|
IdPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get the most recent media published by a user. To get the most recent media published by the owner of the
access token, you can use self instead of the user-id
.
Security scope public_content
is required to read information about other users.
Name | Data Type | Description |
---|---|---|
user-id
|
string |
The ID of a user to get recent media of, or self to retrieve media of authenticated user. |
Name | Data Type | Description |
---|---|---|
max_id
|
string |
Return media earlier than this |
min_id
|
string |
Return media later than this |
min_timestamp
|
long |
Return media after this UNIX timestamp. |
max_timestamp
|
long |
Return media before this UNIX timestamp. |
count
|
integer |
Count of media to return. |
Name | Data Type | Description |
---|---|---|
MediaListResponse
|
object |
pagination
|
IdPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Get basic information about a user. To get information about the owner of the access token, you can use
self instead of the user-id
.
Security scope public_content
is required to read information about other users.
Name | Data Type | Description |
---|---|---|
user-id
|
string |
The ID of a user to get information about, or self to retrieve information about authenticated user. |
Name | Data Type | Description |
---|---|---|
UserResponse
|
object |
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||
data
|
UserInfo |
User basic information |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
text
|
string |
Caption text |
||||||||||||||||
id
|
string |
ID of this caption |
||||||||||||||||
from
|
UserShortInfo |
User who created this caption |
||||||||||||||||
Properties
|
||||||||||||||||||
created_time
|
string |
Caption creation UNIX timestamp |
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
text
|
string |
Text of the comment |
||||||||||||||||
id
|
string |
ID of this comment |
||||||||||||||||
from
|
UserShortInfo |
User who posted this comment |
||||||||||||||||
Properties
|
||||||||||||||||||
created_time
|
string |
Comment creation UNIX timestamp |
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data
|
array [CommentEntry] |
Collection of comment entries; warning: deprecated for Apps created on or after Nov 17, 2015 |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
count
|
integer |
Nember of comments available, data does not necessary contain all comments |
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
data
|
array [CommentEntry] |
Collection of comments |
|||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
next_url
|
string |
URL to retrieve next page of entries |
next_cursor
|
string |
The cursor ID of the next page |
Name | Data Type | Description |
---|---|---|
next_url
|
string |
URL to retrieve next page of entries |
next_max_id
|
string |
The max ID of the next page |
Name | Data Type | Description |
---|---|---|
width
|
integer |
Image/video width in pixels |
url
|
string |
URL of the image/video resource |
height
|
integer |
Image/video height in pixels |
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
thumbnail
|
ImageInfo |
Thumbnail of the image |
|||||||||||||
Properties
|
|||||||||||||||
standard_resolution
|
ImageInfo |
Image in standard resolution |
|||||||||||||
Properties
|
|||||||||||||||
low_resolution
|
ImageInfo |
Image in low resolution |
|||||||||||||
Properties
|
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data
|
array [UserShortInfo] |
Collection of users who liked; warning: deprecated for Apps created on or after Nov 17, 2015 |
||||||||||||||||
Properties
|
||||||||||||||||||
count
|
integer |
Nember of likes available, data does not necessary contain all comments |
Name | Data Type | Description |
---|---|---|
name
|
string |
Location name |
longitude
|
double |
Location longitude |
latitude
|
double |
Location latitude |
id
|
string |
ID of this location (in some responses it has a type of 'integer') |
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
LocationInfo |
Location brief information |
||||||||||||||||
Properties
|
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [LocationInfo] |
List of found locations |
||||||||||||||||
Properties
|
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
videos
|
VideosData |
Videos data in different resolutions, applied for 'video' type |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
users_in_photo
|
array [UserInPhoto] |
Users located on this media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user_has_liked
|
boolean |
Indicates whether authenticated user has liked this media or not |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user
|
UserShortInfo |
User who posted this media |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type
|
string Allowed values: - image - video |
Type of this media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tags
|
array [string] |
List of tags assigned to this media |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
location
|
LocationInfo |
Location data for this media if available |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
link
|
string |
Fixed URL of this media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
likes
|
LikesCollection |
Likes of this media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
images
|
ImagesData |
Images data in different resolutions |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
id
|
string |
ID of a media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
filter
|
string |
Filter of this media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
created_time
|
string |
Media creation UNIX timestamp |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comments
|
CommentsCollection |
Comments of this media entry |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
caption
|
CaptionData |
Describes caption of this media |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
attribution
|
string |
??? Unknown ??? |
Name | Data Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
MediaEntry |
Media resource information |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
pagination
|
IdPaginationInfo |
Information for pagination |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
Found media entries; some end-points do not return likes informtaion |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
code
|
integer |
HTTP result code |
Name | Data Type | Description |
---|---|---|
y
|
float |
Y position (vertical) |
x
|
float |
X position (horizontal) |
Name | Data Type | Description |
---|---|---|
target_user_is_private
|
boolean |
Indicates whether target user is private or not |
outgoing_status
|
string Allowed values: - none - follows - requested |
Status of outgoing relationship |
incoming_status
|
string Allowed values: - none - followed_by - requested_by |
Status of incoming relationship |
Name | Data Type | Description | |||||||
---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
RelationshipStatus |
Current relationship status |
|||||||
Properties
|
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||||||||
Properties
|
|||||||||||||||
data
|
RelationshipInfo |
Relationship information |
|||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
outgoing_status
|
string Allowed values: - none - follows - requested |
Status of outgoing relationship |
Name | Data Type | Description | |||||||
---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
Name | Data Type | Description |
---|---|---|
name
|
string |
Tag name |
media_count
|
long |
Overall number of media entries taged with this name |
Name | Data Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
pagination
|
TagPaginationInfo |
Information for pagination |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries with this tag |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
next_url
|
string |
URL to retrieve next page of entries |
next_min_id
|
string |
Depricated. Use max_tag_id instead |
next_max_tag_id
|
string |
The max ID of a tag for the next page |
next_max_id
|
string |
Depricated. Use min_tag_id instead |
min_tag_id
|
string |
The min ID of a tag for the next page |
deprecation_warning
|
string |
The deprication warning, if information is available |
Name | Data Type | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||
Properties
|
||||||||||||
data
|
array [TagInfo] |
List of found tags with brief statistics |
||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
media
|
integer |
Number of user media |
follows
|
integer |
Number of users followed by this user |
followed_by
|
integer |
Number of followers of this user |
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
user
|
UserShortInfo |
User who is indicated on the photo |
||||||||||||||||
Properties
|
||||||||||||||||||
position
|
Position |
Position in photo |
||||||||||||||||
Properties
|
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
website
|
string |
URL to user web-site |
|||||||||||||
username
|
string |
User name, nickname |
|||||||||||||
profile_picture
|
string |
URL to user profile picture |
|||||||||||||
id
|
string |
User ID |
|||||||||||||
full_name
|
string |
User full name |
|||||||||||||
counts
|
UserCounts |
User statistics (counters) |
|||||||||||||
Properties
|
|||||||||||||||
bio
|
string |
User biography |
Name | Data Type | Description | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||
data
|
UserInfo |
User basic information |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
Name | Data Type | Description |
---|---|---|
username
|
string |
User name, nickname |
profile_picture
|
string |
URL to user profile picture |
id
|
string |
User ID |
full_name
|
string |
User full name |
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
User short information entries |
||||||||||||||||
Properties
|
Name | Data Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
pagination
|
CursorPaginationInfo |
Information for pagination |
||||||||||||||||
Properties
|
||||||||||||||||||
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
List of user short information entries |
||||||||||||||||
Properties
|
Name | Data Type | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
standard_resolution
|
ImageInfo |
Video in standard resolution |
|||||||||||||
Properties
|
|||||||||||||||
low_resolution
|
ImageInfo |
Video in low resolution |
|||||||||||||
Properties
|
'OAuth' Authentication Scheme
Reference: RFC5849, Section 3.5.1
implicit
https://instagram.com/oauth/authorize/
basic
: to read a user's profile info and media (granted by default)likes
: to like and unlike media on a user's behalfcomments
: to post and delete comments on a user's behalffollower_list
: to read the list of followers and followed-by usersrelationships
: to follow and unfollow accounts on a user's behalfpublic_content
: to read any public profile info and media on a user’s behalfquery
access_token
Name | Instagram |
External URL | https://instagram.com/developer/support |
@instagram |
Origin - Format | swagger |
Origin - Url | https://raw.githubusercontent.com/darklynx/swagger-api-collection/master/api/yaml/instagram.yaml |
Origin - Version | 2.0 |
Provider Name | instagram.com |
Unofficial Spec | Yes |
API Version | 1.0.0 |