Get the most recent media published by a user.

GET

/users/{user-id}/media/recent

users

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 Example

Shell

JavaScript

Java

Swift

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

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

Path Params

user-id

string

required

The ID of a user to get recent media of, or self to retrieve media of authenticated user.

Query Params

count

integer

optional

Count of media to return.

max_timestamp

integer

optional

Return media before this UNIX timestamp.

min_timestamp

integer

optional

Return media after this UNIX timestamp.

min_id

string

optional

Return media later than this min_id.

max_id

string

optional

Return media earlier than this max_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