See the list of media liked by the authenticated user.

GET

/users/self/media/liked

users

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 Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.instagram.com/v1/users/self/media/liked'

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
  },
  "pagination": {
    "next_max_id": "string",
    "next_url": "string"
  }
}

Request

Query Params

count

integer

optional

Count of media to return.

max_like_id

string

optional

Return media liked before this id.

Responses

🟢200Users media entries.

application/json

Body

data

array[object (MediaEntry) {16}]

optional

List of media entries

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

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