Release Notes
April 2025
We've added the owner_id column to the MEDIA_HISTORY table.
We've also added the following columns to the USER_HISTORY table:
profile_picture_urlhas_profile_picis_published
We've also added the following columns to the MEDIA_INSIGHTS table:
carousel_album_viewscarousel_album_sharesreel_viewsstory_viewsstory_sharesvideo_photo_viewsvideo_photo_shares
We have upgraded our Instagram Business connector to version 22.0 of the Graph API. We are gradually rolling out this improvement to all existing connectors. For more information about the changes, see Graph API's changelog.
Due to deprecations in Graph API version 22.0, we've removed the following columns from the MEDIA_INSIGHTS table:
reel_clips_replays_countreel_aggregated_all_plays_countreel_plays
Starting from Graph API version 22.0, all impression columns will only be supported for media created before July 2, 2024. All media created after this date will have impression columns set to null. We will continue to support the impression metric on media created before this date.
This change applies to the following columns:
carousel_album_impressionsstory_impressionsvideo_photo_impressions
December 2024
We've removed the video_views column from the MEDIA_INSIGHTS table.
We've also removed the following columns from the USER_INSIGHTS table:
email_contactsget_direction_clicksprofile_viewstext_message_clickswebsite_clicksphone_call_clicks
We made these changes because these metrics are no longer available in the Instagram API.
May 2024
We have added data that represents comments on IG Media to our Instagram Business connector. For more information, see Graph API's IG Comment.
We have added a new table, MEDIA_COMMENT, with the following fields:
created_timehiddenidlike_countmedia_idowner_idowner_usernameparent_idtext
For more information, see the Instagram Business ERD.
March 2024
We have added a new field, story_swipe_forward, to the MEDIA_INSIGHTS table. The story_navigation_action_type field breaks down the navigation field in the MEDIA_INSIGHTS table into the following navigation actions:
story_exitsstory_taps_backstory_taps_forwardstory_swipe_forward
We have upgraded our Instagram Business connector to version 18.0 of the Graph API. We are gradually rolling out this improvement to all existing connectors. For more information about the changes, see Graph API's changelog.
January 2024
We have added a new field, navigation, to the MEDIA_INSIGHTS table.
We have deprecated the following metrics in the MEDIA_INSIGHTS table:
carousel_album_engagementcarousel_album_impressionscarousel_album_reachcarousel_album_savedcarousel_album_video_viewsstory_exitsstory_taps_backstory_taps_forwardvideo_photo_engagement
However, we kept the deprecated metrics to provide backward compatibility, and we will continue to fill them with the values that replaced them. For more details, see Instagram's changelog.
June 2023
We have upgraded our Instagram Business connector to version 17.0 of the Graph API. We are gradually rolling out this change to all existing connectors. For more information about the changes, see Graph API's changelog.
March 2023
We have upgraded our Instagram Business connector from version 15.0 to 16.0 of the Graph API. Learn more about the changes in the Facebook API v16.0 changelog.
October 2022
We have upgraded our Instagram Business connector from version 14.0 to 15.0 of the Graph API. Learn more about the changes in the Facebook API v15.0 changelog.
July 2022
We have added the following new columns to the MEDIA_INSIGHTS table:
reel_commentreel_likesreel_playsreel_reachreel_sharesreel_total_interactions
June 2022
We have upgraded our Instagram Business connector from version 13.0 to 14.0 of the Graph API. Learn more about the changes in the Facebook API v14.0 changelog.
March 2022
We have upgraded our Instagram Business connector from version 12.0 to 13.0 of the Graph API. Learn more about the changes in the Facebook API v13.0 changelog.
We have expanded the public API endpoints Create a connection and Update a connection. Now you can authorize the Instagram Business connector by adding the auth section to payloads.
December 2021
We have released pre-built, dbt Core-compatible data models for Instagram Business. Find the model in Fivetran's dbt hub. Learn more about our dbt Core integration in our Transformations for dbt Core documentation*.
* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.
September 2021
We have upgraded our Instagram Business connector from version 11.0 to 12.0 of the Graph API. Learn more about the changes in the Facebook API v12.0 changelog.
July 2021
Our Instagram Business connector is now generally available.
Read our Instagram Business connector documentation.
We have upgraded our Instagram Business connector from version 8.0 to 11.0 of the Graph API. Learn more about the changes in the Facebook API v11.0 changelog.
June 2021
We have added a new field, followers_count, to the USER_HISTORY table.
January 2021
Instagram Business provides metadata and insights for IG User (Instagram Business Account) and IG Media (Instagram Photo, Video, Story, or Album) objects.