Open navigation

Instagram Insights and Instagram Public Data: Authentication and reauthentication guide

This guide will walk you through how to authenticate or reauthenticate Instagram Insights / Instagram Public Data with Google Sheets, Google Data Studio, and Microsoft Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API. 



Before you begin

To connect Supermetrics to Instagram Insights, you need: 

  • The Instagram account must be an Instagram Business Account (may also be called a "Professional account"). Personal or Creator accounts won't work for this. Visit Instagram’s help center to learn how to change your account type.
  • The Instagram account must be linked to an active Facebook Page.
  • The linked Facebook Page may need to be "claimed" before it can be properly connected
  • The Instagram account needs to use Facebook user authentication. Instagram user authentication won't work.
  • The Facebook user account you use to log into Supermetrics must have sufficient access to the linked Facebook Page. Sufficient access means a valid Facebook user account with permissions sets View Page performance and Create ads. Admin access ( "Admin Access — Manage Page"), while not required, will also work.
  • If you’re using the new Pages experience, you must have full control access to the Facebook Page linked to the Instagram account.


To connect Supermetrics to Instagram Public Data, you need:

Here's an example of sufficient user permissions:



Query types: Instagram Public Data


Profile info
  • Returns the current amount of followers, follows, and posts for the account user search for.
  • Returns basic account info: name, username, Instagram ID, bio, profile pic URL, website link.

Recommended uses

Follow development of follower amount of other accounts, or their posting frequency, using the Supermetrics “Combine new results” feature.


Limitations

  • Private, restricted, or age-limited data can’t be fetched.
  • Error: Invalid profile name” can mean that the account name is invalid or that the account is restricted, age-limited, or private. Historical data of account followers or post amounts can't be fetched. However, you can use the “Append results” and scheduled refresh features to gather data over time.
Profile posts
  • Returns posts of pages that are publicly available.
  • Post types include image, video, and carousel. Please note that stories, Reels, and IGTV content is not supported.
  • Can fetch data from the past and from a selected time period. Can also be used to get data on posts that are otherwise geo-restricted.
  • Shows basic post metrics (likes, comments), and post URL, image URL (first image for carousel), post type, caption, and more, together with profile information.


Recommended uses:

  • Follow new posts from multiple accounts, that are difficult to manage. 
  • Find and analyze top-performing posts from other accounts, like. which content types, hashtags, and captions are performing well.
Post search

Allows you to search for posts tagged with a specific hashtag.

The hashtag can be either in the post caption or in as a comment. Hashtags can be added only by the original poster.

Post search has two query types: Top and Recent.

  • Top returns a list of 100 top posts based on Instagram's algorithm rather than on likes or comments.
  • Recent returns a list of posts made within the last 24 hours with the specified hashtag.


Recommended uses:

  • Follow discussions happening with specific hashtags.
  • Follow and store new posts with specific hashtags.
  • Find other hashtags used together in popular posts.
  • Find which profiles are popular and are discussing using specific hashtags.


Data protection agreement 

If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.


Instructions


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Click Add-ons → Supermetrics → Launch to open the sidebar.
  3. Under Data source, select Instagram Insights/Instagram Public Data.
  4. Click Start.
  5. A Facebook login page will open. Enter your credentials, and click Log in.
  6. Alternatively, if you're already logged into Facebook in the browser, click Continue with Facebook
  7. Click Continue as to authenticate with that user account. If you want to authenticate with a different user account, click Log in to another account.
  8. Hand-pick your accounts and click Next.
  9. Hand-pick your Pages and click Next.
  10. For Instagram Public Data:

    Navigate to Report configuration.
    Under Query type, select the query type.
    Under Instagram profiles, insert the Instagram profiles.

    For Instagram Insights:
    Under Select accounts, select the accounts.

Reauthenticate

Learn how to reauthenticate the data source with Supermetrics in Google Sheets.

Next steps

Learn how to create your first Supermetrics query with Instagram Public Data and Instagram Insights. 


Troubleshooting

  • If you still don’t see the right Instagram account in Supermetrics after following these steps, use this guide to troubleshoot the issue.
  • If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide
  • If you encounter a permission error such as “user permission denied” or similar, follow this guide.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.