This page contains the setup guide and reference information for Instagram.
Features
| Feature | Supported? |
|---|---|
| Full Refresh - Overwrite | Yes |
| Full Refresh - Append | Yes |
| Incremental - Append | Yes |
| Incremental - Append + Deduped | Yes |
Note: Incremental sync modes are only available for the User Insights stream.
Prerequisites
- Instagram business account linked to your Facebook page
- Meta for Developers account
- Facebook ad account ID number
- Access Token generated using Graph API Explorer or by using an app you created on Facebook
Setup guide
Step 1: Connect you Instagram account to your Facebook Page
On yuor Facebook Page, click Professional dashboard.
Inside your dashboard, scroll down and find Linked accounts on the left sidebar.
Choose Instagram and click Connect account. You will be asked to login to your Instagram account. Once done, your Instagram account will be connected to your Facebook page.
Step 2: Obtain credentials to set up Instagram
Use 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
Follow the guide here to obtain your Facebook ad account ID number.
You're ready to set up Instagram in Daspire!
Step 3: Set up Instagram in Daspire
Select Instagram from the Source list.
Enter a Source Name.
Enter Access Token you obtained in Step 2.
(Optional) Enter the Start Date in
YYYY-MM-DDTHH:mm:ssZformat. 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 Save & Test.
Output schema
This Source is capable of syncing the following core Streams:
Data type mapping
| Integration Type | Daspire Type |
|---|---|
string | string |
number | number |
array | array |
object | object |
Performance considerations
Instagram limits the number of requests that can be made at a time, but the Instagram integration gracefully handles rate limiting. See Facebook's documentation on rate limiting for more information.
Troubleshooting
Max number of tables that can be synced at a time is 6,000. We advise you to adjust your settings if it fails to fetch schema due to max number of tables reached.