Instagram Basic Display API

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/{api-version}/{user-id}/media
  ?access_token={access-token}

Path Parameters

PlaceholderValue

{api-version}
String

API version.

{user-id}
Required
String

App user's app-scoped user ID (version 11.0+) or raw user ID (all versions).

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.

since
timestamp

A Unix timestamp or strtotime data value that points to the start of a range of time-based data. See time-based pagination.

until
timestamp

A Unix timestamp or strtotime data value that points to the end of a range of time-based data. See time-based pagination.

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/v18.0/10218560180051171/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.