Loading...

Instagram Insights

Data from the Instagram Business/Creator account linked to your Page: engagement, reach, views, followers.

The Instagram Insights connector brings into the sheet the data of the Instagram Business or Creator account linked to a Facebook Page you administer: engagement, reach, views, follower trends and profile contact-button taps.

The connection reuses the same Facebook access: the connector discovers your Pages and, for each one, the linked Instagram professional account, if any.

Permessi richiesti

  • pages_show_list : Needed to discover the Facebook Page linked to the Instagram account.
  • pages_read_engagement : Needed to read the metadata of the Facebook Page the Instagram account is linked to.
  • business_management : Needed to discover Pages managed through a Meta Business Portfolio, whose linked Instagram account is then used for the report.
  • instagram_basic : Needed to read the profile and identify the Instagram account linked to the Page.
  • instagram_manage_insights : Needed to read the Instagram account's insights data (engagement, reach, views, followers).

Metriche disponibili

Metrica Periodo Aggregazione Note
Accounts Engaged day sum
Total Interactions day sum
Likes day sum
Saves day sum Can rarely be negative on a single day: this is a known Meta behavior, not an error. See Known limits.
Shares day sum
Replies day sum
Reposts day sum Can rarely be negative on a single day: this is a known Meta behavior, not an error. See Known limits.
Reach day sum
Views day sum
New Follows day sum
Unfollows day sum
Profile Contact Button Taps day sum

Dimensioni disponibili

Dimensione Note
Date Adds one row per day in the selected period. Without this dimension the report returns a single total aggregated over the whole period. See Known limits for generation time with this dimension enabled.

Limiti noti

  • Max 30 days per call
    Unlike Facebook Page Insights (93 days), the Instagram API accepts at most 30 days per single call. Longer periods are automatically split into 30-day blocks and summed.
  • Longer report generation time with the "Date" dimension
    Instagram does not return a daily series in a single call: to get a value for each day in the period, the connector makes one separate API call per day (roughly 1 call per second, a 19-day report takes about 17 seconds). This is expected behavior, not an anomaly. For long reports with this dimension, we recommend a dedicated Google Sheet, separate from other reports, so it doesn't slow down faster reports in the same trigger.
  • Negative values on "Saves"/"Reposts"
    In rare cases Instagram can return a negative value for these metrics on a single day. This is a known Meta behavior (not a connector bug), related to how removals are counted against new additions within the same period.