Meta has revealed significant changes to its Instagram Graph API and Marketing API, aimed at simplifying integration development for businesses. These updates include endpoint consolidation and new metrics implementation.
The platform is implementing a streamlined approach by replacing several endpoints with unified alternatives:
Instagram User
βIG User
Instagram Media
andInstagram Carousel
βIG Media
Instagram Comment
βIG Comment
Migration Timeline
Meta has established two key deadlines for developers:
- Marketing API Endpoints: January 21, 2026
- Graph API Endpoints: April 21, 2025
Field Changes and Removals
Discontinued Fields
Several fields will be removed from the platform:
- Instagram Media: filter_name, location details, and carousel child media information
- Instagram Comment: mentioned_instagram_users and comment_type
- Instagram User: is_private field
New Features
The updated IG User
endpoint introduces new capabilities:
- has_profile_picture
- is_published
- authorized_adaccounts
- agencies
- upcoming_events
Views Metric Implementation
Following Instagram's August 2024 update introducing Views as the primary consumption metric, the API now includes:
- Views metrics across all media types (Reels, Live, Photos, Carousels, Stories)
- User insights with multi-dimensional breakdowns
- Integration across all API versions
Metric Deprecations
Starting with v22, the following metrics will be deprecated:
- plays (media insights)
- clips_replays_count
- ig_reels_aggregated_all_plays_count
- impressions (for media created after July 2, 2024)