This page guides you through the process of setting up the instagram source connector.
Prerequisites
- A Facebook App
- An Instagram Business Account
- A Facebook Page linked to your Instagram Business Account
- A Facebook API Access Token
Step 1: Set up Instagram
Facebook App
If you don't have a Facebook App
Visit the Facebook Developers App hub and create an App and choose "Manage Business Integrations" as the purpose of the app. Fill out the remaining fields to create your app.
Facebook Page
See the Facebook support for information about how to add an Instagram Account to your Facebook Page.
Instagram Business Account
Follow the Instagram documentation for setting up an Instagram business account. We'll need this ID to configure Instagram as a source in Airbyte.
Step 2: Set up the Instagram connector in Airbyte
For Airbyte Cloud:
- Log into your Airbyte Cloud account.
- In the left navigation bar, click Sources. In the top-right corner, click + new source.
- On the source setup page, select Instagram from the Source type dropdown and enter a name for this connector.
- Select
Authenticate your account
. - Log in and Authorize to the Instagram account and click
Set up source
.
For Airbyte OSS:
- For using an Access Tokens, set up instagram (see step above).
- Generate Access Tokens with the following permissions:
- instagram_basic
- instagram_manage_insights
- pages_show_list
- pages_read_engagement
- Instagram Public Content Access
- Go to local Airbyte page.
- In the left navigation bar, click Sources. In the top-right corner, click + new source.
- On the Set up the source page, enter the name for the Instagram connector and select Instagram from the Source type dropdown.
- Paste your Access Tokens from step 2.
- Click
Set up source
.
Supported sync modes
The Instagram source connector supports the following sync modes:
- Full Refresh
- Incremental
Supported Streams
For more information, see the Instagram API and Instagram Insights API documentation.
Features
Feature | Supported?(Yes/No) | Notes |
---|---|---|
Full Refresh Sync | Yes | |
Incremental Sync | Yes | only User Insights |
Rate Limiting & Performance Considerations
Instagram, like all Facebook services, has a limit on the number of requests, but Instagram connector gracefully handles rate limiting.
See Facebook's documentation on rate limiting for more information.
Data type map
Integration Type | Airbyte Type |
---|---|
string | string |
number | number |
array | array |
object | object |
Changelog
Version | Date | Pull Request | Subject |
---|---|---|---|
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. |