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