Before you connect to Instagram, Meta requires that your account be set up correctly. Make sure the Instagram account:

We also recommend logging out of all other Instagram accounts in your browser before you connect, to avoid connection conflicts.

Once the requirements above are met, follow these steps to connect Instagram to a Client:

Step 1: Open the Client where you'd like to connect to Instagram, then click Data at the top.

Step 2: Click +Connect Data Source in the upper right corner of the page.

Step 3: Search for Instagram in the search bar, then click the Instagram card.

Step 4: Click + Connect New Account. If you've already connected to Instagram before, click the + Connect New Account button below the existing connections list.

Step 5: In the pop-up, sign in to the Facebook account associated with the Instagram account, and accept any authorization or permission prompts.

Step 6: Click Edit Settings in the Facebook pop-up to select all relevant Pages and enable permissions.

Step 7: Click Done, then OK to finalize the Facebook authorization.

Step 8: Select the account you want to connect to this Client, then click Connect in the lower left.

Once connected, your Client's Instagram metrics will be pulled in, so you can start building custom reports or dashboards.

If you encounter a failed connection, incorrect data, or an error message after connecting to Instagram, find your issue below.

If your Instagram account doesn't show up when connecting, check that:

If the wrong Instagram profile appears during connection:

If Instagram shows as connected but its data isn't appearing in reports, remove the account and reconnect it as a new account. This refreshes the authentication token.

If Instagram still won't connect after the steps above, Meta requires specific account setup and permissions for the user connecting the account. Work through the permission checks below, then re-authenticate the connection.

The user connecting to Instagram needs to have Facebook Page Access and Full Permissions for the associated Facebook Page. Check out Meta Support if you are unsure.

The connecting user's Facebook account must have manage access for the Instagram account you're trying to connect. This is managed in the Linked Accounts section on Facebook.

The Linked Accounts page confirms that the Facebook account has access to manage the Instagram account you're trying to connect. If you are unsure if the accounts are connected, contact Meta Support.

With Page Access permissions confirmed and the Facebook Page set to manage the Instagram account, re-enter your Instagram credentials to re-authenticate the connection.

Step 1: Open the Client you're connecting to Instagram.

Step 2: Click Data at the top, then click Connect Data Source in the top right.

Step 3: Search for Instagram or scroll to find it, then click the tile.

Step 4: Click the grey Connect New Account button at the bottom, even if your account is already showing in the list.

This launches the Facebook and Instagram authentication window.

Step 5: Sign in to the Facebook account you just verified is connected to Instagram.

Step 6: On the next page of the pop-up, click Edit Settings.

Step 7: Select all the Pages you'd like to connect to AgencyAnalytics.

Step 8: Click Next.

Step 9: On the following page, toggle all permissions to Yes. If some are disabled, Facebook may not give you access to your data.

Step 10: Click Done, then click Okay to finalize.

Step 11: Choose the exact account you'd like to integrate, then click Save.

To connect your Instagram account to a Facebook Page, make sure the Instagram account is linked in Facebook Business Manager.

Instagram's API only returns data for organic likes, not paid likes. Instagram doesn't count likes on ads when it reports your social data.

We use Instagram's API to pull in Instagram data and display it for your Clients, so we're limited to the data Instagram makes available. Since paid likes aren't included, you'll often see a lower like count on your dashboard than on your native Instagram account if you're running paid campaigns.

The Views metric currently includes only data from posts and reels and excludes data from other sources, such as Stories, IGTV, and IG Live. This is working as expected, given how the metric is retrieved via Instagram’s API, but Meta’s native tools (such as Meta Business Suite) include additional content types, which explains the discrepancy you are seeing.

Facebook's API doesn't provide audience demographic breakdowns for accounts with fewer than 100 followers. If your client's Instagram account is below that threshold, Age & Gender data won't be available until the account reaches 100 followers.

Instagram currently has a limitation: the demographic breakdown of followers does not update when the selected report date changes. You can also check this within the native Instagram mobile app under Insights, where the same breakdown is shown regardless of the chosen date.

AgencyAnalytics can display up to 3 years of historical follower data for most Instagram Business accounts. This includes Total Followers, Followers Gained, and Followers Lost. The amount of historical data available varies by account: if there's limited history or none at all, follower tracking will begin from the date you connect Instagram to AgencyAnalytics. Note: the account must have at least 5 followers for historical data to be available.

If a piece of content appears on the Instagram profile but not in a Posts widget, it may be a Reel. Instagram displays both Posts and Reels together in the default grid view, but they're tracked separately in AgencyAnalytics.

To see both Posts and Reels in one place, use the Posted Content table widget.

Instagram Stories are only available via the API for 24 hours after they're posted. Once a Story expires, its data is no longer accessible. There are also a few types of Stories that won't appear at all:

This depends on who owns the post. If your client is the original post owner and collaborates with others, the post will appear in AgencyAnalytics. However, if someone else owns the post and your client is listed as a collaborator, the post will not appear: Instagram's API only returns posts owned by the connected account.

AgencyAnalytics doesn't currently support Instagram sub-accounts. You'll need to connect each account individually.

The totals are estimated differently. Not all Instagram users share demographic information such as location, gender, or age, so follower counts broken down by these dimensions are estimates based on available data, not exact figures. The two tabs may show different totals as a result. This is expected behavior from Instagram's side, not a data error.

The play count shown directly on a Reel on Instagram includes plays from both Instagram and Facebook, plus video replays. AgencyAnalytics pulls data from the Instagram API only, which reports initial plays, first-time views, not replays, and Instagram only.

To compare accurately, click on the Reel in Instagram to open Reel Insights and look at the "Initial Plays" figure, that's the number that will match what's shown in your AgencyAnalytics widgets.

AgencyAnalytics can only pull Instagram data from the date your account was switched to a Professional (Business or Creator) account. Instagram doesn't make data from before that switch available via their API, so we're unable to show it.

If you have any questions, please contact our friendly support team by following these instructions. We're available 24/5 to help.