User Media

Represents a collection of Media on a User.

Creating

This operation is not supported.

Reading

GET /{user-id}/media

Get a collection of Media on a User.

Limitations

Stories are not supported.
Media in promoted posts are not supported.
Returns a maximum of 10K of the most recently created media.

Requirements

Type	Requirement
Access Tokens	Instagram User
Permissions	`instagram_graph_user_media`, `instagram_graph_user_profile`

Request Syntax

GET https://graph.instagram.com/{user-id}/media
  ?access_token={access-token}

Query String Parameters

Include the following query string parameters to augment the request.

Key	Value
`access_token` Required String	The app user's Instagram User Access Token.
`fields` Comma-separated list	A comma-separated list of Media fields you want returned by field-expansion for each Media node in the result set.

Response

A JSON-formatted object containing the data you requested.

{
  "data": [],
  "paging": {}
}

Response Contents

Property	Value
`data`	An array of Media on the User.
`paging`	An object containing paging cursors and next/previous data set retrievial URLs.

cURL Example

Request

curl -X GET \
  'https://graph.instagram.com/17841405793187218/media?access_token=IGQVJ...'

Response

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Updating

This operation is not supported.

Deleting

This operation is not supported.