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

TypeRequirement

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.

KeyValue

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

PropertyValue

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.