Description of Instagram RESTful API.
Current limitations:
- Instagram service does not support cross origin headers for security reasons, therefore it is not possible to use Swagger UI and make API calls directly from browser.
- Modification API requests (
POST,DELETE) require additional security scopes that are available for Apps created on or after Nov 17, 2015 and started in Sandbox Mode. - Consider the Instagram limitations for API calls that depends on App 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
Resources
comments
Manage comments
Remove a comment either on the authenticated user's media object or authored by the authenticated user.
Request
Path
| Name | Data Type | Description |
|---|---|---|
comment-id
|
string |
The ID of the comment entry. |
media-id
|
string |
The ID of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
StatusResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
|||||||
Get a list of recent comments on a media object.
Request
Path
| Name | Data Type | Description |
|---|---|---|
media-id
|
string |
The ID of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
CommentsResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
data
|
array [CommentEntry] |
Collection of comments |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
Create a comment on a media object with the following rules:
- The total length of the comment cannot exceed 300 characters.
- The comment cannot contain more than 4 hashtags.
- The comment cannot contain more than 1 URL.
- The comment cannot consist of all capital letters.
Request
Path
| Name | Data Type | Description |
|---|---|---|
media-id
|
string |
The ID of the media resource. |
Query
| Name | Data Type | Description |
|---|---|---|
text
|
string |
Text to post as a comment on the media object as specified in |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
StatusResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
|||||||
geographies
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
Request
Path
| Name | Data Type | Description |
|---|---|---|
geo-id
|
string |
The geography ID. |
Query
| Name | Data Type | Description |
|---|---|---|
min_id
|
string |
Return media before this |
count
|
integer |
Max number of media to return. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaListResponse
|
object |
Properties
pagination
|
IdPaginationInfo |
Information for pagination |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
array [MediaEntry] |
List of media entries |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
likes
Manage likes
Remove a like on this media by the currently authenticated user.
Request
Path
| Name | Data Type | Description |
|---|---|---|
media-id
|
string |
The ID of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
StatusResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
|||||||
Get a list of users who have liked this media.
Request
Path
| Name | Data Type | Description |
|---|---|---|
media-id
|
string |
The ID of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
UsersInfoResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
media-id
|
string |
The ID of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
StatusResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
|||||||
locations
Get information about locations
Search for a location by geographic coordinate.
Request
Query
| 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. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
LocationSearchResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
location-id
|
string |
The location ID. |
Query
| 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. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaListResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
location-id
|
string |
The location ID. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
LocationInfoResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
LocationInfo |
Location brief information |
||||||||||||||||
Properties
|
||||||||||||||||||
media
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
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaSearchResponse
|
object |
Properties
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.
Request
Query
| 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, |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaSearchResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
shortcode
|
string |
The short code of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaEntryResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
media-id
|
string |
The ID of the media resource. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaEntryResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
MediaEntry |
Media resource information |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
relationships
Relationships to other users outgoing and incoming
List the users who have requested this user's permission to follow.
Responses
Body
| Name | Data Type | Description |
|---|---|---|
UsersInfoResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
user-id
|
string |
The ID of a user, or self to retrieve information about authenticated user. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
UsersPagingResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
user-id
|
string |
The ID of a user, or self to retrieve information about authenticated user. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
UsersPagingResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
user-id
|
string |
The ID of a user to get information about. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
RelationshipResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||||||||
Properties
|
|||||||||||||||
data
|
RelationshipInfo |
Relationship information |
|||||||||||||
Properties
|
|||||||||||||||
Modify the relationship between the current user and the target user.
Request
Path
| Name | Data Type | Description |
|---|---|---|
user-id
|
string |
The ID of the target user. |
Query
| Name | Data Type | Description |
|---|---|---|
action
|
string Allowed values: - follow- unfollow- block- unblock- approve- ignore |
Type of action to apply for relationship with the user. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
RelationshipPostResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
RelationshipStatus |
Current relationship status |
|||||||
Properties
|
|||||||||
tags
Get information about tags
Search for tags by name.
Request
Query
| Name | Data Type | Description |
|---|---|---|
q
|
string |
A valid tag name without a leading #. (eg. snowy, nofilter) |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
TagSearchResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
tag-name
|
string |
The tag name. |
Query
| 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. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
TagMediaListResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
tag-name
|
string |
The tag name. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
TagInfoResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
||||||||||
Properties
|
||||||||||||
data
|
TagInfo |
Tag brief information |
||||||||||
Properties
|
||||||||||||
users
Get information about users
Search for a user by name.
Request
Query
| Name | Data Type | Description |
|---|---|---|
count
|
integer |
Number of users to return. |
q
|
string |
A query string. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
UsersInfoResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
User short information entries |
||||||||||||||||
Properties
|
||||||||||||||||||
Request
Query
| 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. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaListResponse
|
object |
Properties
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.
Request
Query
| Name | Data Type | Description |
|---|---|---|
max_like_id
|
string |
Return media liked before this id. |
count
|
integer |
Count of media to return. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaListResponse
|
object |
Properties
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.
Request
Path
| 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. |
Query
| 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. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
MediaListResponse
|
object |
Properties
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.
Request
Path
| Name | Data Type | Description |
|---|---|---|
user-id
|
string |
The ID of a user to get information about, or self to retrieve information about authenticated user. |
Responses
Body
| Name | Data Type | Description |
|---|---|---|
UserResponse
|
object |
Properties
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||
data
|
UserInfo |
User basic information |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||
Models
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 |
||||||||||||||||
Properties
| 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 |
||||||||||||||||
Properties
| 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 |
|||||||||||||||||||||||||||||||||||
Properties
| Name | Data Type | Description | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
data
|
array [CommentEntry] |
Collection of comments |
|||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||
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 |
Properties
| 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 |
Properties
| 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 |
Properties
| 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
|
|||||||||||||||
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 |
||||||||||||||||
Properties
| 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') |
Properties
| Name | Data Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
LocationInfo |
Location brief information |
||||||||||||||||
Properties
|
||||||||||||||||||
Properties
| Name | Data Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [LocationInfo] |
List of found locations |
||||||||||||||||
Properties
|
||||||||||||||||||
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 ??? |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
| Name | Data Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data
|
MediaEntry |
Media resource information |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Properties
| Name | Data Type | Description |
|---|---|---|
code
|
integer |
HTTP result code |
Properties
| Name | Data Type | Description |
|---|---|---|
y
|
float |
Y position (vertical) |
x
|
float |
X position (horizontal) |
Properties
| 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 |
Properties
| Name | Data Type | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
RelationshipStatus |
Current relationship status |
|||||||
Properties
|
|||||||||
Properties
| Name | Data Type | Description | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||||||||
Properties
|
|||||||||||||||
data
|
RelationshipInfo |
Relationship information |
|||||||||||||
Properties
|
|||||||||||||||
Properties
| Name | Data Type | Description |
|---|---|---|
outgoing_status
|
string Allowed values: - none- follows- requested |
Status of outgoing relationship |
Properties
| Name | Data Type | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||
Properties
|
|||||||||
data
|
string |
No data - 'null' |
|||||||
Properties
| Name | Data Type | Description |
|---|---|---|
name
|
string |
Tag name |
media_count
|
long |
Overall number of media entries taged with this name |
Properties
| 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
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
Properties
| Name | Data Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||
Properties
|
||||||||||||
data
|
array [TagInfo] |
List of found tags with brief statistics |
||||||||||
Properties
|
||||||||||||
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 |
Properties
| Name | Data Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
user
|
UserShortInfo |
User who is indicated on the photo |
||||||||||||||||
Properties
|
||||||||||||||||||
position
|
Position |
Position in photo |
||||||||||||||||
Properties
|
||||||||||||||||||
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 |
|||||||||||||
Properties
| Name | Data Type | Description | |||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||
data
|
UserInfo |
User basic information |
|||||||||||||||||||||||||||||||||||||||||
Properties
|
|||||||||||||||||||||||||||||||||||||||||||
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 |
Properties
| Name | Data Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
meta
|
MetaData |
Response meta-data |
||||||||||||||||
Properties
|
||||||||||||||||||
data
|
array [UserShortInfo] |
User short information entries |
||||||||||||||||
Properties
|
||||||||||||||||||
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
|
||||||||||||||||||
Properties
| Name | Data Type | Description | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
standard_resolution
|
ImageInfo |
Video in standard resolution |
|||||||||||||
Properties
|
|||||||||||||||
low_resolution
|
ImageInfo |
Video in low resolution |
|||||||||||||
Properties
|
|||||||||||||||
Authentication
'OAuth' Authentication Scheme
Reference: RFC5849, Section 3.5.1
implicitAuthorization URL:
https://instagram.com/oauth/authorize/Scopes:
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 behalf
-
Location:
query -
Query Parameter Name:
access_token
Contact
| Name | Instagram |
| External URL | https://instagram.com/developer/support |
@instagram |
Metadata (Technical Details)
| 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 |