instagram.md

Instagram

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
• Instagram Graph API to your Facebook app
• Facebook API access token
• Facebook ad account ID number (you'll use this to configure Instagram as a source in Airbyte)

Setup Guide

Step 1: Set up Instagram​

Generate access tokens with the following permissions:

• instagram_basic
• instagram_manage_insights
• pages_show_list
• pages_read_engagement
• Instagram Public Content Access

Step 2: Set up the Instagram connector in Airbyte

For Airbyte Cloud

1. Log in to your Airbyte Cloud account.
2. Click Sources and then click + New source.
3. On the Set up the source page, select Instagram from the Source type dropdown.
4. Enter a name for your source.
5. Click Authenticate your Instagram account.
6. Log in and authorize the Instagram account.
7. Enter the Start Date in YYYY-MM-DDT00:00:00Z format. All data generated after this date will be replicated. If this field is blank, Airbyte will replicate all data.
8. Click Set up source.

For Airbyte Open Source

1. Log in to your Airbyte Open Source account.
2. Click Sources and then click + New source.
3. On the Set up the source page, select Instagram from the Source type dropdown.
4. Enter a name for your source.
5. Click Authenticate your Instagram account.
6. Log in and authorize the Instagram account.
7. Enter the Start Date in YYYY-MM-DDT00:00:00Z format. All data generated after this date will be replicated. If this field is blank, Airbyte will replicate all data.
8. Paste the access tokens from Step 1.
9. Click Set up source.

Supported sync modes

The Instagram source connector supports the following sync modes:

• Full Refresh - Overwrite
• Full Refresh - Append
• Incremental - Append
• Incremental - Deduped History

:::note

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.

• User
  • User Insights
• Media
  • Media Insights
• Stories
  • Story Insights

Rate Limiting and Performance Considerations

Instagram limits the number of requests that can be made at a time, but the Instagram connector gracefully handles rate limiting. See Facebook's documentation on rate limiting for more information.

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

Changelog

Version	Date	Pull Request	Subject
1.0.0	2022-09-23	17110	Remove custom read function and migrate to per-stream state
0.1.11	2022-09-08	16428	Fix requests metrics for Reels media product type
0.1.10	2022-09-05	16340	Update to latest version of the CDK (v0.1.81)
0.1.9	2021-09-30	6438	Annotate Oauth2 flow initialization parameters in connector specification
0.1.8	2021-08-11	5354	added check for empty state and fixed tests.
0.1.7	2021-07-19	4805	Add support for previous format of STATE.
0.1.6	2021-07-07	4210	Refactor connector to use CDK: - improve error handling. - fix sync fail with HTTP status 400. - integrate SAT.