Instagram API
  1. media
Instagram API
  • geographies
    • Get recent media from a custom geo-id.
      GET
  • locations
    • Search for a location by geographic coordinate.
      GET
    • Get information about a location.
      GET
    • Get a list of recent media objects from a given location.
      GET
  • media
    • Get a list of currently popular media.
      GET
    • Search for media in a given area.
      GET
    • Get information about a media object.
      GET
    • Get information about a media object.
      GET
  • comments
    • Get a list of recent comments on a media object.
      GET
    • Create a comment on a media object.
      POST
    • Remove a comment.
      DELETE
  • likes
    • Remove a like on this media by the current user.
      DELETE
    • Get a list of users who have liked this media.
      GET
    • Set a like on this media by the current user.
      POST
  • tags
    • Search for tags by name.
      GET
    • Get information about a tag object.
      GET
    • Get a list of recently tagged media.
      GET
  • users
    • Search for a user by name.
      GET
    • See the authenticated user's feed.
      GET
    • See the list of media liked by the authenticated user.
      GET
    • Get basic information about a user.
      GET
    • Get the most recent media published by a user.
      GET
  • relationships
    • List the users who have requested this user's permission to follow.
    • Get the list of users this user is followed by.
    • Get the list of users this user follows.
    • Get information about a relationship to another user.
    • Modify the relationship between the current user and the target user.
  1. media

Get information about a media object.

GET
/media/{media-id}
media
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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.instagram.com/v1/media/'
Response Response Example
{
    "data": {
        "attribution": "string",
        "caption": {
            "created_time": "string",
            "from": {
                "full_name": "string",
                "id": "string",
                "profile_picture": "string",
                "username": "string"
            },
            "id": "string",
            "text": "string"
        },
        "comments": {
            "count": 0,
            "data": [
                {
                    "created_time": "string",
                    "from": {
                        "full_name": "string",
                        "id": "string",
                        "profile_picture": "string",
                        "username": "string"
                    },
                    "id": "string",
                    "text": "string"
                }
            ]
        },
        "created_time": "string",
        "filter": "string",
        "id": "string",
        "images": {
            "low_resolution": {
                "height": 0,
                "url": "string",
                "width": 0
            },
            "standard_resolution": {
                "height": 0,
                "url": "string",
                "width": 0
            },
            "thumbnail": {
                "height": 0,
                "url": "string",
                "width": 0
            }
        },
        "likes": {
            "count": 0,
            "data": [
                {
                    "full_name": "string",
                    "id": "string",
                    "profile_picture": "string",
                    "username": "string"
                }
            ]
        },
        "link": "string",
        "location": {
            "id": "string",
            "latitude": 0,
            "longitude": 0,
            "name": "string"
        },
        "tags": [
            "string"
        ],
        "type": "image",
        "user": {
            "full_name": "string",
            "id": "string",
            "profile_picture": "string",
            "username": "string"
        },
        "user_has_liked": true,
        "users_in_photo": [
            {
                "position": {
                    "x": 0,
                    "y": 0
                },
                "user": {
                    "full_name": "string",
                    "id": "string",
                    "profile_picture": "string",
                    "username": "string"
                }
            }
        ],
        "videos": {
            "low_resolution": {
                "height": 0,
                "url": "string",
                "width": 0
            },
            "standard_resolution": {
                "height": 0,
                "url": "string",
                "width": 0
            }
        }
    },
    "meta": {
        "code": 0
    }
}

Request

Path Params
media-id
string 
required
The ID of the media resource.

Responses

🟢200Media resource information.
application/json
Body
data
object (MediaEntry) 
optional
attribution
string 
optional
??? Unknown ???
caption
object (CaptionData) 
optional
comments
object (CommentsCollection) 
optional
created_time
string 
optional
Media creation UNIX timestamp
filter
string 
optional
Filter of this media entry
id
string 
optional
ID of a media entry
images
object (ImagesData) 
optional
likes
object (LikesCollection) 
optional
link
string 
optional
Fixed URL of this media entry
location
object (LocationInfo) 
optional
tags
array[string]
optional
List of tags assigned to this media
type
enum<string> 
optional
Type of this media entry
Allowed values:
imagevideo
user
object (UserShortInfo) 
optional
user_has_liked
boolean 
optional
Indicates whether authenticated user has liked this media or not
users_in_photo
array[object (UserInPhoto) {2}] 
optional
Users located on this media entry
videos
object (VideosData) 
optional
meta
object (MetaData) 
optional
code
integer <int32>
optional
HTTP result code
Previous
Get information about a media object.
Next
Get a list of recent comments on a media object.
Built with