IG Media

Represents an Instagram album, photo, or video (uploaded video, live video, reel, or story).

Introducing the following field:

• legacy_instagram_media_id

The following Marketing API Instagram Ads endpoint fields are not supported:

• filter_name
• location
• location_name
• latitude
• longitude

Creating

This operation is not supported.

Reading

GET /<IG_MEDIA_ID>

Gets fields and edges on Instagram media.

Requirements

Limitations

• Fields such as comments_count and like_count return engagement on the target Instagram media only and don't include data from other surfaces. For example, comments_count returns the number of comments on a photo, but not comments on ads that contain that photo. Use total_comments_count and total_like_count to get aggregated counts that include engagement from promoted/boosted/ad media. Crossposted Facebook post's count may be included if that post is accessible by the session user.
• Captions don't include the @ symbol unless the app user is also able to perform admin-equivalent tasks on the app.
• Some fields, such as permalink, cannot be used on photos within albums (children).
• Live video Instagram Media can only be read while they are being broadcast.
• This API returns only data for media owned by Instagram professional accounts. It can not be used to get data for media owned by personal Instagram accounts.
• The reposts_count, saved_count, shares_count, total_like_count, total_comments_count, and total_views_count fields are not available for carousel child media and are only returned for top-level media objects. The media owner can disable showing likes, comments, views, reposts, and shares — in these cases, the corresponding fields are not returned.

Request Syntax

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Path Parameters

Query String Parameters

Fields

Public fields can be read via field expansion.

Edges

Public edges can be returned through field expansion.

cURL Example

Example request

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

Example response

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Updating

POST /<IG_MEDIA_ID>

Enable or disable comments on an Instagram Media.

Limitations

Live video Instagram Media not supported.

Request Syntax

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Path Parameters

Query String Parameters

cURL Example

Example request

curl -i -X POST \
 "https://graph.instagram.com/v25.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Example response

{
  "success": true
}

Deleting

DELETE /<IG_MEDIA_ID>

Delete Instagram Media.

Requirements

Limitations

This api only supports Instagram API with Facebook login only. Non-ad posts, Stories, Reels and entire carousel albums are supported. To delete media inside carousel albums, the entire carousel album must be deleted by specifying the carousel container media id. Individually deleting media within a carousel is not supported.

Request Syntax

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Path Parameters

Query String Parameters

cURL Example

Example request

curl -i -X DELETE \
 "https://graph.facebook.com/v25.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Example response (Success)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Example response (Failure, Media Type Not Supported)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}