2025-01 Instagram upgrade Social v21

Introduction

Starting on January 30th, 2025, Instagram’s API will be upgraded from v19 to v21. This upgrade introduces changes to deprecated metrics, reporting limitations, and data availability, requiring updates to your integration for continued functionality.

Key Changes in Instagram API v21

Deprecated Fields and Metrics

Insight Account Metrics

The following metrics have been deprecated and will no longer be available:

• email_contacts
• get_direction_clicks
• profile_views
• text_message_clicks
• website_clicks
• phone_call_clicks

Timeframe Deprecations

The following timeframes are no longer supported for the metrics reached_audience_demographics and engaged_audience_demographics:

• last_14_days
• last_30_days
• last_90_days
• prev_month

Insight Media Metrics

• video_views is now deprecated.

Insight Account API Limitations

Metrics for Small Accounts

• The follower_count and online_followers metrics will not be available for Instagram business or creator accounts with fewer than 100 followers.

Data Availability for online_followers

• Insights data for the online_followers metric will only be available for the last 30 days.

Handling Missing Data

• If insights data is unavailable or does not exist, the API will return an empty data set instead of 0 for individual metrics.

Demographic Metrics

• Demographic metrics will only include data for the top 45 performers.
• Metrics are calculated using only viewers for whom demographic data is available, which may result in totals less than the follower count.

Delayed Metrics Data

• Data used for calculating metrics may experience delays of up to 48 hours.

Recommended Actions

1. For Deprecated Metrics:

   • Remove any references to deprecated metrics from your integration.
   • Update schema mappings to avoid null or empty values in your reports.

2. For New Limitations:

   • Review account and demographic data queries to account for changes in availability and restrictions.
   • Modify reporting to reflect potential delays and the limited scope of top-performer demographic metrics.

3. Account Adjustments:

   • Ensure compliance with the minimum follower count requirements to access key metrics.