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/shortcode/{shortcode}
media
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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.instagram.com/v1/media/shortcode/'
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
shortcode
string 
required
The short code 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
Modified at 2023-08-15 03:55:31
Previous
Search for media in a given area.
Next
Get information about a media object.
Built with