Instagram Platform Updates & Release Notes

Download and copyright protections on media_url

Download and copyright protections on media_url

Applies to all versions.

The media_url field on the IG Media endpoint is now omitted from responses in either of these cases:

• The video contains copyrighted or licensed audio, including audio added from the Instagram audio library, or it has been flagged for a copyright violation. This applies to all video media, including reels, video posts, and video stories, and applies even when the app user owns the media.
• The reel owner has turned off downloads for the reel, through either the account-level or per-reel Allow people to download your reels setting. This applies to reels only, and only on the endpoints listed below that read other users’ media. The setting is evaluated against the reel’s owner, so it can apply to a reel you co-authored. Reading your own media through GET //media or GET / is not affected by this condition.

This gives media returned by the Instagram APIs the same download and copyright protections that already apply in the Instagram app. All other fields on the media object, such as id, permalink, caption, and timestamp, are returned as normal. Image media and carousel containers are not affected, though a carousel’s video children can be. Requests still return a 200 response. Treat media_url as an optional field in your app and fall back to permalink or thumbnail_url when it is absent.

This change applies to both graph.facebook.com and graph.instagram.com.

Endpoints affected by both the download setting and copyright checks

• GET /?fields=business_discovery{media}
• GET //tags
• GET //mentioned_media
• GET //mentioned_comment
• GET //top_media
• GET //recent_media
• GET //collaborative_media

Endpoints affected by the copyright check only

• GET /
• GET //children
• GET //media
• GET //stories
• GET //live_media
• GET //collaboration_invites

Nested media reached through field expansion, such as carousel children or the media on a comment, inherit the conditions that apply to the originating request. For example, GET //children is subject to the copyright check alone, but children returned by business_discovery{media{children}} are also subject to the download setting.

For more information, see Allow people to download your reels⁠ This link opens in a new tab or window, Copyright⁠ This link opens in a new tab or window, and Using audio in reels⁠ This link opens in a new tab or window.

AI Info Label

Applies to all versions.

The Content Publishing API now supports self-disclosure of AI-generated content at publish time. Set the new is_ai_generated parameter to true when creating a media container to apply the AI info label. For carousels, set is_ai_generated on the carousel container only. Available in both Instagram API with Facebook Login and Instagram API with Instagram Login. is_ai_generated field is also now available on the IG Media endpoint.

Endpoints

• POST /{ig_user_id}/media with the is_ai_generated parameter
• GET /{ig_media_id}?fields=is_ai_generated

Instagram Audio API

Applies to all versions.

Introducing the Instagram Audio API for apps using Facebook Login. The API lets your app search for and retrieve audio — original sounds from Reels and royalty-free music from Meta's Sound Collection — and attach it to Reels at creation time.

This release also adds an ads use case for discovering replacement audio for Instagram Reels ads: when a Reel contains copyrighted music, your app can find royalty-free Sound Collection tracks to replace it. To apply a discovered track to a Reels ad, see IG Audio Swap for Instagram Reels Ads.

Endpoints

• GET /ig_audio?audio_type={music|original_sound} — Search or retrieve trending audio
• GET /{ig_audio_id} — Get metadata for a specific audio asset
• GET /ig_audio?product=ADS&purpose=AUDIO_COPYRIGHT_REPLACEMENT&audio_replacement_mode={auto|search|default}&ig_media_id={ig_media_id} — Discover replacement audio for Reels ads

New Media Engagement Fields

Applies to all versions.

Three new fields are now available on the IG Media endpoint for apps using Facebook Login, giving deeper insight into how content is being distributed:

• reposts_count — Number of times the media has been reposted by other users
• saved_count — Number of times the media has been saved
• shares_count — Number of times the media has been shared

Endpoint

• GET /{ig_media_id}?fields=reposts_count,saved_count,shares_count

Aggregated Metrics

Applies to all versions.

Introducing three new aggregated metrics that provide comprehensive engagement totals across all surfaces, including boosted media and Facebook crossposted content. These values match what users see in the Instagram Insights Dashboard and are available through both the IG Media and Insights endpoints:

• total_like_count / total_likes — Aggregated likes across Instagram, Facebook, and promoted media
• total_comments_count / total_comments — Aggregated comments across all surfaces
• total_views_count / total_views — Aggregated views across all surfaces (video media only)

Endpoints

• GET /{ig_media_id}?fields=total_like_count,total_comments_count,total_views_count
• GET /{ig_media_id}/insights?metric=total_likes,total_comments,total_views

Enhanced Views Metrics

Applies to all versions.

• facebook_views expansion: The facebook_views metric now supports Feed post, Reels, and Story media types, and coverage has expanded to include both crossposted plays and cross-app recommended plays.
• Cross-platform view_count: The view_count field now returns combined Instagram and Facebook views for crossposted video content when looking up another user's public media via the Business Discovery API.

Endpoints

• GET /{ig_media_id}/insights?metric=facebook_views
• GET /{ig_user_id}?fields=business_discovery.username({username}).media{view_count}

Collaborative Media API

Applies to all versions.

Introducing the Collaborative Media API on the IG User. The API lets your app retrieve all media where your app user is an accepted collaborator, making it easier to track and measure performance of collaborative content across partnerships.

Endpoints

• GET //collaborative_media — Fetch all collaborative media for the app user
• GET /?fields=collaborative_media_search.media_id() — Search for a specific collaborative media

Partnership Ads Label

Applies to all versions.

The Content Publishing API now supports adding the "Paid partnership" disclosure label at publish time, eliminating the need to manually add partnership labels after publishing. Two new parameters have been added to the create media endpoint:

• branded_content_sponsor_ids — Tag up to 2 brand partners by their Instagram user ID
• is_paid_partnership — Enable the "Paid partnership" label with or without naming specific brands

Endpoint

• POST //media with branded_content_sponsor_ids and is_paid_partnership parameters

See the updated post-level permissioning guidance for details on brand approval flows.

Like Media and Comments API

Applies to all versions.

Introducing the Like Media and Comments API on the IG User. The API lets your app like and unlike Instagram media and comments on behalf of your app users, enabling engagement workflows such as responding to comments on business posts or engaging with collaborative content.

Endpoints

• POST //likes with media_id={media_id} or comment_id={comment_id} — Like a Feed post, Reel, comment, or reply
• DELETE //likes with media_id={media_id} or comment_id={comment_id} — Unlike a Feed post, Reel, comment, or reply

The new instagram_manage_engagement permission is required. Stories and content from private accounts are not supported.

Creator Marketplace

Applies to all versions.

The Creator Marketplace API now includes several new capabilities for discovering and evaluating creators:

• Rate limit increase: Account-level rate limits for the Discovery API have increased from 240 to 1,000 queries per user per hour, enabling faster, higher-volume creator search.
• Profile picture URL: A new profile_picture_url field is available when querying creator profiles.
• Past partnership ads media: You can now query a creator's historical partnership ads media that the creator owns.
• New filters: Three new filtering options — follower growth (top growth in last 30 days), latest activity (recently posted creators), and device type (iOS/Android audience filtering).

See Creator Marketplace API documentation for more information.

Partnership Ads

Applies to all versions.

• Username filtering on ad permissions: The /{business-account-id}/branded_content_ad_permissions endpoint now supports filtering by creator_username, allowing you to search and retrieve ad permissions for a specific creator. See Account-Level Permissioning for more information.
• Ad code generation: Creators can now generate partnership ad codes through the API, enabling automated workflows for branded content authorization. See Ad Codes for more information.

Applies to all versions.

Introducing Accept/Decline Collaboration Invites in Instagram API with Facebook Login on the IG User. The API provides the following capabilites:

• Query all the IG Media(s) where the app user's Instagram user has been invited for collaboration
• Accept/Decline a collaboration invite using media_id of the tagged IG Media

Endpoints

• GET //collaboration_invites
• POST //collaboration_invites

instagram_basic permission is required to access these endpoints.