This page contains the setup guide and reference information for the Instagram source connector.
Prerequisites
- Meta for Developers account
- Instagram business account to your Facebook page
- Facebook ad account ID number (you'll use this to configure Instagram as a source in Airbyte
- Instagram Graph API to your Facebook app
- Facebook Instagram OAuth Reference
Setup Guide
Set up the Instagram connector in Airbyte
For Airbyte Cloud:
- Log in to your Airbyte Cloud account.
- Click Sources and then click + New source.
- On the Set up the source page, select Instagram from the Source type dropdown.
- Enter a name for your source.
- Click Authenticate your Instagram account.
- Log in and authorize the Instagram account.
- (Optional) Enter the Start Date in YYYY-MM-DDTHH:mm:ssZ format. All data generated after this date will be replicated. If left blank, the start date will be set to 2 years before the present date.
- Click Set up source.
For Airbyte Open Source:
- Log in to your Airbyte Open Source account.
- Click Sources and then click + New source.
- On the Set up the source page, select Instagram from the Source type dropdown.
- Enter a name for your source.
- Enter Access Token generated using Graph API Explorer or by using an app you can create on Facebook with the required permissions: instagram_basic, instagram_manage_insights, pages_show_list, pages_read_engagement.
- (Optional) Enter the Start Date in YYYY-MM-DDTHH:mm:ssZ format. All data generated after this date will be replicated. If left blank, the start date will be set to 2 years before the present date.
- Click Set up source.
Supported sync modes
The Instagram source connector supports the following sync modes:
Incremental sync modes are only available for the User Insights stream.
Supported Streams
The Instagram source connector supports the following streams. For more information, see the Instagram Graph API and Instagram Insights API documentation.
The Instagram connector syncs data related to Users, Media, and Stories and their insights from the Instagram Graph API. For performance data related to Instagram Ads, use the Facebook Marketing source.
Data type map
AirbyteRecords are required to conform to the Airbyte type system. This means that all sources must produce schemas and records within these types and all destinations must handle records that conform to this type system.
Integration Type | Airbyte Type |
---|---|
string | string |
number | number |
array | array |
object | object |