Media

Represents an a image, video, or album.

Creating

This operation is not supported.

Reading

GET /{media-id}

Get fields and edges on an image, video, or album.

Requirements

TypeRequirement

Access Tokens

Instagram User

Permissions

instagram_graph_user_media

Request Syntax

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &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 fields and edges you want returned. If omitted, default fields will be returned.

Fields

You can use the fields query string parameter to request the following fields on a User.

Field NameDescription

caption

The Media's caption text. Not returnable for Media in albums.

id

The Media's ID.

media_type

The Media's type. Can be IMAGE, VIDEO, or CAROUSEL_ALBUM.

media_url

The Media's URL.

permalink

The Media's permanent URL.

thumbnail_url

The Media's thumbnail image URL. Only available on VIDEO Media.

timestamp

The Media's publish date in ISO 8601 format.

username

The Media owner's username.

Edges

You can use request the following edges as path parameters or by using the fields query string parameter.

EdgeDescription

children

Get a list of Media on the Media album. Only available on CAROUSEL_ALBUM Media.

Response

A JSON-formatted object containing default and requested fields and edges.

{
  "{field}":"{value}",
  ...
}

cURL Example

Request

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Response

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Updating

This operation is not supported.

Deleting

This operation is not supported.