• 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 /<IG_USER_ID>/media or GET /<IG_MEDIA_ID> is not affected by this condition.

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

• GET /<IG_MEDIA_ID>
• GET /<IG_MEDIA_ID>/children
• GET /<IG_USER_ID>/media
• GET /<IG_USER_ID>/stories
• GET /<IG_USER_ID>/live_media
• GET /<IG_USER_ID>/collaboration_invites

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

• GET /{ig_media_id}/insights?metric=link_clicks

• 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

• media_audio_type — The type of audio used in the media: MUSIC (licensed music from Meta’s catalog) or ORIGINAL_SOUND (original audio). Returned for video media such as Reels.

• GET /{ig_media_id}?fields=media_audio_type

• 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

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

• 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)

• 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

• 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.

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

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

• 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

• POST /<IG_USER_ID>/media with branded_content_sponsor_ids and is_paid_partnership parameters

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

• 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).

• 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.

• 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

• GET /<IG_USER_ID>/collaboration_invites
• POST /<IG_USER_ID>/collaboration_invites

• reels_skip_rate
• reposts

• reposts

• crossposted_views
• facebook_views

DELETE /{ig_media_id}

• views

Metric Deprecations

• clips_replays_count on media insights
• ig_reels_aggregated_all_plays_count on media insights
• impressions on media and user insights
• plays on media insights

• GET /{instagram-user-id}
• GET /{instagram-user-id}/agencies
• GET /{instagram-user-id}/upcoming-events
• GET /{instagram-user-id}/authorized-adaccounts
• POST /{instagram-user-id}/upcoming-events
• POST /{instagram-user-id}/authorized-adaccounts
• GET /{instagram-media-id}
• GET /{instagram-media-id}/comments
• GET /{instagram-carousel-id}
• GET /{instagram-carousel-id}/comments
• GET /{instagram-comment-id}
• GET /{instagram-comment-id}/replies
• POST /{instagram-media-id}/comments
• POST /{instagram-carousel-id}/comments
• POST /{instagram-comment-id}/replies
• POST /{instagram-comment-id}
• DELETE /{instagram-comment-id}
• GET /{page-id}/instagram-accounts
• GET /{page-id}/page-backed-instagram-accounts
• GET /{business-id}/owned-instagram-accounts
• GET /{business-id}/instagram-accounts
• GET /{business-asset-group-id}/contained-instagram-accounts
• GET /{fb-business-user-id}/assigned-instagram-accounts
• GET /{fb-user-id}/assigned-instagram-accounts
• GET /{fb-system-user-id}/assigned-instagram-accounts
• GET /{ad account id}/instagram-accounts
• GET /{ad account id}/connected-instagram-accounts-with-iabp
• POST /{page-id}/page-backed-instagram-accounts
• DELETE /{business-id}/instagram-accounts

• GET /{ig-media-id}/insights
  • video_views

• GET /{ig-user-id}/insights
  • email_contacts
  • get_direction_clicks
  • profile_views
  • text_message_clicks
  • website_clicks
  • phone_call_clicks

• instagram_business_basic
• instagram_business_content_publish
• instagram_business_manage_comments
• instagram_business_manage_messages

• A Facebook Page will no longer be required
• The host URL for API calls is graph.instagram.com
• New permissions for this API:
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages
• The Messenger API will no longer be used to send Instagram messages
• New apps will add the new Instagram product when creating a Meta app
• Existing apps can add the new Instagram product in the App Dashboard

• GET /{ig-user-id}/insights
  • engaged_audience_demographics
  • reached_audience_demographics

• GET /{ig-user-id}/insights
  • AUDIENCE_GENDER_AGE
  • AUDIENCE_LOCALE
  • AUDIENCE_COUNTRY
  • AUDIENCE_CITY
• GET /{ig-media-id}/insights
  • CAROUSEL_ALBUM_IMPRESSIONS
  • CAROUSEL_ALBUM_REACH
  • CAROUSEL_ALBUM_ENGAGEMENT
  • CAROUSEL_ALBUM_SAVED
  • CAROUSEL_ALBUM_VIDEO_VIEWS
  • TAPS_FORWARD
  • TAPS_BACK
  • EXITS
  • ENGAGEMENT

• For Stories created by users in the EEA, the replies metric will now return a value of 0.
• For Stories created by users outside the EEA, the replies metric will return the number of replies, but replies made my users in the EEA will not be included in its calculation.

• IG User Insights — The follower_count values now align more closely with their corresponding values displayed in the Instagram app. In addition, follower_count now returns a maximum of 30 days of data instead of 2 years. This change applies to v9.0+ and will apply to all versions May 9, 2021.

• Hashtag Search — This change applies to v7.0+ — You can now request the timestamp field on IG Media returned by GET /{ig-hashtag-id}/top_media and GET /{ig-hashtag-id}/recent_media Hashtag Search queries. For example: GET /{ig-hashtag-id}/top_media?fields=timestamp.

• Insights — To align API behavior with Instagram app behavior, insights on IG Users are now only available on IG Users that have 100 or more followers.

• Business Discovery — The Business Discovery API can now be used to get data about other Instagram Creator accounts.

• Instagram Creator Accounts — The API now supports Instagram Creator Accounts⁠, with two exceptions. (1) The Content Publishing API cannot be used by Instagram Creators, and (2) the Business Discovery API can be used by Creators but can only target Businesses.

• Webhooks — The story_insights field now requires the instagram_manage_insights permission instead of instagram_manage_comments.

• Hashtag Search API — You can now search for media tagged with specific hashtags by using our new Hashtag Search API. #spooky!

• /{ig-media-id}/comments edge — GET requests made using API version 3.1 or older will have results returned in chronological order. Requests made using version 3.2+ will have results returned in reverse chronological order.

• /{ig-media-id} node — You can now use field expansion to get the permalink field on media objects.

• Business Verification — In order to use the Instagram Graph API, all apps must undergo Business Verification, which is part of the App Review process and now required for all Instagram Graph API endpoints. Apps previously reviewed before May 1st, 2018, have to be reviewed again, and have until August 1st, 2018 to do so, or lose access to the API.

• /{ig-comment-id} node:
  • Added a new username field.
  • For GET requests, the user field will not be included in responses unless the User making the request owns the Comment; instead, we will return username for all commenters. This also applies to queries on Comments made through other APIs, such as the Mentions API.
• /{ig-media-id} node:
  • Added a new username field.
  • For GET requests, the owner field will not be included in responses unless the User making the request owns the media object; instead, we will return username for all commenters. This also applies to queries on media objects made through other APIs, such as the Mentions API.

• Insights API — Insights will now include ad activity generated through the API, Facebook ads interfaces, and Instagram’s Promote feature. This affects the following metrics:

  • impressions
  • reach

• Content Publishing API — Beta partners can now use the /{ig-user-id}/media edge to tag locations and public Instagram users when publishing photos.

• Public fields — The timestamp field on the /{ig-media-id} node is now a public field and can be returned via field expansion.

• Public fields — The /{ig-user-id}, /{ig-comment-id}, and /{ig-media-id} nodes will now return all public fields when accessed through an edge via field expansion. Refer to each node’s reference document to see which fields are public.

• Content Publishing API — Beta partners can now include hashtags when publishing photos via the /{ig-user-id}/media edge. #crazywildebeest FTW!