Open navigation

Instagram Public Data connection guide

This guide contains all permissions and requirements for connecting your Instagram Public Data data to Supermetrics.


You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.


After you connect to the data source on the Hub, you can use the data source connection in all available destinations.


Required permissions

To connect Instagram Public Data to Supermetrics, you need a Facebook user account linked to an Instagram account with the Manage Page role. Learn more in Instagram's documentation.


Instagram permissions

Your Instagram account must be:

  • An Instagram Business account (sometimes called a "professional account"), or a Creator account that uses Facebook authentication and isn't restricted, age-limited, or private.
  • Linked to an active Facebook Page which has been claimed.

Visit Instagram's help center to learn how to change your account type.

Facebook permissions

Your Facebook account must:

  • Be a Facebook user account with View performance permissions.
  • If it's using the new Pages experience, the account needs Insights access to the Facebook Page linked to the Instagram account.

Story, Reel, and IGTV data aren't available for Instagram Public Data. See the list of available data fields in our technical documentation.


Query types

When you connect Instagram Public Data, you'll use a query type to define your data. Browse these below.


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.

To use this query type, add the Instagram profile names to the query setup. If you're querying multiple profile names, separate the names by commas.


Recommended uses

Keep track of an account's follower count, or its 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.
  • 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), post URL, image URL (first image for carousel), post type, caption, and more, together with profile information.
To use this query type, add the Instagram profile names to the query setup. If you're querying multiple profile names, separate the names by commas.


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 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.


Connection instructions

When connecting to Instagram Public Data, you need to log in to Facebook and select the acounts to pull data from when prompted. 

  1. Select the Instagram Public Data data source on the Supermetrics Hub or in the data destination.
  2. If prompted, choose to make this connection shared or private.
  3. Click Start.
  4. Log in with a new Facebook account, or click Reconnect to log in with the account you're currently logged in to.
  5. Select the Businesses, Pages, and Instagram Accounts you want to include in your reporting.
  6. Review the permissions, and click Save.
  7. Click Got it.
  8. In your data destination, select the accounts to use in your query and a query type, if prompted.


See detailed instructions on how to connect to a data source from the Supermetrics Hub.


You can also connect to Instagram Public Data from these destinations:


More resources

Did you find it helpful? Yes No

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