This source can sync data for the Instagram Business Account available in the Facebook Graph API: User, Media, and Stories. It can also sync Media/Story and User Insights.
This Source is capable of syncing the following core Streams:
For more information, see the Instagram API and Instagram Insights API documentation.
| Integration Type | Airbyte Type | Notes |
|---|---|---|
string |
string |
|
number |
number |
|
array |
array |
|
object |
object |
|
| Namespaces | No |
| Feature | Supported?(Yes/No) | Notes |
|---|---|---|
| Full Refresh Sync | Yes | |
| Incremental Sync | Yes | only User Insights |
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.
- A Facebook App
- An Instagram Business Account
- A Facebook Page linked to your Instagram Business Account
- A Facebook API Access Token
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.
See the Facebook support for information about how to add an Instagram Account to your Facebook Page.
Follow the Instagram documentation for setting up an Instagram business account. We'll need this ID to configure Instagram as a source in Airbyte.
To work with the Instagram connector, you need to generate an Access Token with the following permissions:
- instagram_basic
- instagram_manage_insights
- pages_show_list
- pages_read_engagement
- Instagram Public Content Access
More details how to get a User's Access Token you can find in the following docs: Access Tokens and User and Page Access Tokens
With the Instagram Account ID and API access token, you should be ready to start pulling data from the Facebook Instagram API. Head to the Airbyte UI to setup your source connector!
| 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. |