Instagram Graph API

Media

This node allows you to:

This node's edges allow you to:

Please note that you cannot use this node to get media objects. To get all media objects on an Instagram Business Account, use the /user/media edge instead.

Creating

This operation is not supported. To create comments, use this node's /media/comments edge instead.

Reading

Getting Metadata

To get an individual media object's metadata, send a GET request to the /media node and include any of the fields below.

Limitations

  • Fields that return aggregated values will not include ads-driven data. For example, comments_count will count comments on a photo, but not comments on ads that contain that photo.
  • Captions that @mention an Instagram Business Account will not include the (@) symbol unless the request is made by the Instagram Business Account that owns the media object upon which the caption was made.
  • Some fields cannot be used on photos within album carousels (children).

Fields

  • caption* (excludes carousel children)
  • children* (carousel albums only)
  • comments (excludes carousel children, replies to comments, and the caption)
  • comments_count* (excludes carousel children, includes replies, includes the caption)
  • id*
  • ig_id
  • is_comment_enabled (excludes carousel children)
  • like_count* (excludes carousel children, includes replies)
  • media_type*
  • media_url*
  • owner (only returned if the User making the query also owns the media object, otherwise the username field will be included)
  • permalink*
  • shortcode
  • thumbnail_url (only available on videos)
  • timestamp*
  • username*

Fields marked with an asterisk (*) are public fields, which means they can be returned by an edge using field expansion.

Permissions

A User access token with the following permissions:

  • instagram_basic

If the token is for a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

Sample Request

GET graph.facebook.com
  /17895695668004550?fields=id,media_type,media_url,owner,timestamp

Sample Response

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/h-ak-fbx/t51.2885-9/21227247_1640962412602631_3222510491855224832_n.jpg?_nc_log=1",
  "owner": {
    "id": "17841405822304914"
  },
  "timestamp": "2017-08-31T18:10:00+0000"
}

Updating

Enabling/Disabling Comments

To toggle comments on or off for an individual media object, send a POST request to the /media node and include the comment_enabled=true or comment_enabled=false parameter.

Permissions

A User access token with the following permissions:

  • instagram_basic
  • instagram_manage_comments

If the token is for a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

Sample Request

POST graph.facebook.com
  /17895695668004550?comment_enabled=false

Sample Response

{
  "success": true
}

Deleting

This operation is not supported.