IG Media
Updated: Jun 22, 2026
Represents an Instagram album, photo, or video (uploaded video, live video, reel, or story).
If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.
Introducing the following field:
legacy_instagram_media_id
The following Marketing API Instagram Ads endpoint fields are not supported:
filter_namelocationlocation_namelatitudelongitude
Creating
This operation is not supported.
Reading
GET /<IG_MEDIA_ID>Requirements
| Instagram API with Instagram Login | Instagram API with Facebook Login | |
|---|---|---|
Access Tokens |
| |
Host URL | graph.instagram.com | graph.facebook.com |
Login Type | Business Login for Instagram | Facebook Login for Business |
|
If the app user was granted a role via the Business Manager on the Page connected to your app user’s Instagram professional account, your app will also need one of:
|
Limitations
- Fields such as
comments_countandlike_countreturn engagement on the target Instagram media only and don’t include data from other surfaces. For example,comments_countreturns the number of comments on a photo, but not comments on ads that contain that photo. Usetotal_comments_countandtotal_like_countto 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, andtotal_views_countfields 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
| Placeholder | Value |
|---|---|
<API_VERSION>The latest version is: v25.0 |
The API version your app is using. If not specified in your API calls this will be the latest version at the time you created your Meta app or, if that version is no longer available, the oldest version available.Learn more about versioning. |
<HOST_URL> | The host URL your app is using to query the endpoint. |
<IG_MEDIA_ID> | Required. ID for the media to be published. |
Query String Parameters
| Key | Placeholder | Value |
|---|---|---|
access_token | <ACCESS_TOKEN> | Required. The app user’s Facebook or Instagram User access token. |
fields | <LIST_OF_FIELDS> | Comma-separated list of fields you want returned. |
Fields
Public fields can be read via field expansion.
| Field | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
alt_text
Public | Descriptive text for images, for accessibility. | ||||||||||||||||
boost_ads_list | Offers an overview of all Instagram ad information associated with the organic media for ads with ACTIVE status. It includes relative ad ID and ad delivery status. Available for Instagram API with Facebook Login only. | ||||||||||||||||
boost_eligibility_info | The field provides information about boosting eligibility of a Instagram instagram media as an ad and additional details if not eligible. Available for Instagram API with Facebook Login only. | ||||||||||||||||
caption
Public | Caption. Excludes album children. The @ symbol is excluded, unless the app user can perform admin-equivalent tasks on the Facebook Page connected to the Instagram account used to create the caption. Available for Instagram API with Facebook Login only. | ||||||||||||||||
comments_count
Public | Count of comments on the media. Excludes comments on album child media and the media’s caption. Includes replies on comments. | ||||||||||||||||
copyright_check_information.status | Returns status and matches_found objects
If a video is violating copyright, the copyright_matches is returned with an array of objects about the copyrighted material, when the violation is occurring in the video, and the actions take to mitigate the violation.
| ||||||||||||||||
id
Public | Media ID. | ||||||||||||||||
is_ai_generated | Indicates if the media has an AI label. Excludes album children. | ||||||||||||||||
is_comment_enabled | Indicates if comments are enabled or disabled. Excludes album children. | ||||||||||||||||
is_shared_to_feed
Public | For Reels only. When true, indicates that the reel can appear in both the Feed and Reels tabs. When false, indicates that the reel can only appear in the Reels tab.Neither value determines whether the reel actually appears in the Reels tab because the reel may not meet eligibilty requirements or may not be selected by our algorithm. See reel specifications for eligibility critera. | ||||||||||||||||
legacy_instagram_media_id | The ID for Instagram media that was created for Marketing API endpoints for v21.0 and older. | ||||||||||||||||
like_count | Count of likes on the media, including replies on comments. Excludes likes on album child media and likes on promoted posts created from the media.
If queried indirectly through another endpoint or field expansion the like_count field is omitted if the media owner has hidden like counts. | ||||||||||||||||
media_audio_type
Public | The type of audio used in the media. Can be MUSIC or ORIGINAL_SOUND. Returned only for video media such as Reels; not returned for other media types (for example, photos and carousels). | ||||||||||||||||
media_product_type
Public | Surface where the media is published. Can be AD, FEED, STORY or REELS. Available for Instagram API with Facebook Login only. | ||||||||||||||||
media_type
Public | Media type. Can be CAROUSEL_ALBUM, IMAGE, or VIDEO. | ||||||||||||||||
media_url
Public | The URL for the media. The media_url field is omitted from responses if the media contains copyrighted material or has been flagged for a copyright violation. Examples of copyrighted material can include audio on Reels. | ||||||||||||||||
owner
Public | Instagram user ID who created the media. Only returned if the app user making the query also created the media; otherwise, username field is returned instead. | ||||||||||||||||
permalink
Public | Permanent URL to the media. | ||||||||||||||||
shortcode
Public | Shortcode to the media. | ||||||||||||||||
thumbnail_url
Public | Media thumbnail URL. Only available on VIDEO media. | ||||||||||||||||
timestamp
Public | ISO 8601-formatted creation date in UTC (default is UTC ±00:00). | ||||||||||||||||
username
Public | Username of user who created the media. | ||||||||||||||||
view_count
Public | View count for Instagram Reels, which includes both paid and organic metrics. For content crossposted to Facebook, this returns combined Instagram and Facebook view counts if the Facebook post is accessible by the session user. Available for Business Discovery API only. | ||||||||||||||||
reposts_count
Public | Number of times the media has been reposted. Available for FEED and REELS media. Not accessible through hashtag API endpoints. Available for Instagram API with Facebook Login only. | ||||||||||||||||
saved_count | Number of times the media has been saved. Available for FEED and REELS media. Only accessible by the media owner or an accepted collaborator. Not accessible through Business Discovery, tagged/mentioned media, or hashtag API endpoints. Available for Instagram API with Facebook Login only. | ||||||||||||||||
shares_count | Number of times the media has been shared. Available for FEED and REELS media. Not accessible through Business Discovery or hashtag API endpoints. Available for Instagram API with Facebook Login only. | ||||||||||||||||
total_comments_count
Public | Total number of comments on the media across all surfaces, including comments on associated promoted/boosted media. Not accessible through hashtag API endpoints. Available for Instagram API with Facebook Login only. | ||||||||||||||||
total_like_count
Public | Total number of likes on the media across all surfaces, including likes on associated promoted/boosted media. Not accessible through hashtag API endpoints. Available for Instagram API with Facebook Login only. | ||||||||||||||||
total_views_count | Total view count of video content across all surfaces, including views from promoted/boosted media and replays. Only available for video media. Not accessible through Business Discovery or hashtag API endpoints. For Business Discovery, use view_count instead. Available for Instagram API with Facebook Login only. |
Edges
Public edges can be returned through field expansion.
| Edge | Description |
|---|---|
children
Public. | Represents a collection of Instagram Media objects on an album Instagram Media. |
Represents a list of users who are added as collaborators on an Instagram Media object. Available for Instagram API with Facebook Login only. | |
Represents a collection of Instagram Comments on an Instagram Media object. | |
Represents social interaction metrics on an Instagram Media object. |
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.
Requirements
| Instagram API with Instagram Login | Instagram API with Facebook Login | |
|---|---|---|
Access Tokens |
| |
Host URL | graph.instagram.com | graph.facebook.com |
Login Type | Business Login for Instagram | Facebook Login for Business |
|
If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:
|
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
| Placeholder | Value |
|---|---|
<API_VERSION>The latest version is: v25.0 |
The API version your app is using. If not specified in your API calls this will be the latest version at the time you created your Meta app or, if that version is no longer available, the oldest version available.Learn more about versioning. |
<HOST_URL> | The host URL your app is using to query the endpoint. |
<IG_MEDIA_ID> | Required. ID for the media to be published. |
Query String Parameters
| Key | Placeholder | Value |
|---|---|---|
access_token | <ACCESS_TOKEN> | Required. App user’s user access token. |
comment_enabled | <BOOL> | Required. Set to true to enable comments or false to disable comments. |
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
| Instagram API with Facebook Login | |
|---|---|
Access Tokens | |
Host URL | graph.facebook.com |
Login Type | Facebook Login for Business |
|
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
| Placeholder | Value |
|---|---|
<API_VERSION>The latest version is: v25.0 |
The API version your app is using. If not specified in your API calls this will be the latest version at the time you created your Meta app or, if that version is no longer available, the oldest version available.Learn more about versioning. |
<IG_MEDIA_ID> | Required. ID for the media to be published. |
Query String Parameters
| Key | Placeholder | Value |
|---|---|---|
access_token | <ACCESS_TOKEN> | Required. App user’s user access token. |
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" }, }