Instagram Business

Last updated on Feb 27, 2024

From Release 2.19.3, Hevo has upgraded to v18.0 of the Marketing API. You may need to reauthorize Hevo for existing Pipelines. Refer to section, Add an Instagram Business account and authorize Hevo for the authorization steps.


The new API version impacts data ingestion for the following objects:

Objects Changes
media_comments_insights - Destination tables video_insights_lifetime, carousel_album_insights_lifetime, and image_insights_lifetime replaced by video_insights_lifetime_v2, carousel_album_insights_lifetime_v2, and image_insights_lifetime_v2.
story - Destination table story_insights_lifetime replaced by story_insights_lifetime_v2.
user_insights_lifetime - Source object schema changed and replaced by new objects user_age_insights_lifetime, user_gender_insights_lifetime and user_country_insights_lifetime.
- Corresponding Destination tables created as user_age_insights_lifetime_v2, user_gender_insights_lifetime_v2, and user_country_insights_lifetime_v2.


Hevo ingests the new objects by default in the existing Pipelines. You can skip them from the Pipeline Detailed View, if required.

Instagram Business is used by both content creators and businesses to publish posts and stories. You need an Instagram Business account to get insights on how these posts and stories and your account are performing.

Instagram is managed by Facebook. Therefore, each of your Instagram Business accounts must be linked to a Facebook page. However, one Facebook account may be linked to up to five Instagram Business accounts. To fetch your Instagram data, Hevo uses your Facebook login credentials to authenticate the respective Instagram Business account.

You can create Pipelines in Hevo that read your data using the Facebook Marketing API and load it to a Destination system of your choice.


Source Considerations

  • Instagram allows you to fetch data of up to two years from the current date.

  • Instagram allows you to create a business account and link it to Facebook only via the mobile app.

  • Instagram Business aggregates the follower_count metric over a rolling window of the last 30 days. It does not capture any data updates made outside of this window.

  • Hevo fetches only the latest 10,000 media entities each time the media_detail object is ingested due to the constraints imposed by Instagram.


Limitations

  • Hevo currently does not support the Hashtags object.

Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Jan-29-2024 2.19.3 - Added a warning container at the top of the page to mention the Marketing API v18.0 update.
- Updated sections, Data Model, Schema and Primary Keys, and Data Replication to add information about changes to the Instagram ERD with the Marketing API v18.0 update.
Oct-17-2022 NA Updated the section, Source Considerations to include information about the rolling window imposed by Instagram on the ingestion of the follower_count metric.
Jul-27-2022 NA Updated Note in section, Data Replication.
Apr-11-2022 1.86 Added a note in section, Data Replication to inform about optimized quota consumption for Full Load objects.
Dec-20-2021 1.78 Added ‘media_comment_insights’ to the list of objects under Data Replication, Incremental Data section.
Oct-25-2021 NA Added the Pipeline frequency information in the Data Replication section.
Sep-20-2021 1.72 - Replaced media with media_detail in the Data Replication and Data Model sections.
- Updated the section, Source Considerations to include information about the constraints imposed by Instagram on the ingestion of the media_detail object.
Jul-26-2021 NA Added a note in the Overview section about Hevo providing a fully-managed Google BigQuery Destination for Pipelines created with this Source.
Apr-06-2021 1.60 New document

Tell us what went wrong