instagram-insights

Discover various insights from your Instagram data.

Use-cases

• Find out which users are not following you back
• Export followers and following user lists in various formats (table, json, yaml)
• Set sorting criteria and order direction of the results
• Limit the number of results to get a quick overview (e.g. top 10)

Prerequisites

Complete all steps from this section.

Request to download your Instagram data

You need to get a copy of your Instagram data using the Data Download tool. This is a manual process that cannot be automated. Instagram only allows their mobile application and website to perform this. While requesting a download of your data, select the following options:

• Types of information:
  • Followers and following
• Format:
  • JSON
• Date range:
  • All time

Prepare your Instagram data

When your Instagram data is ready to be downloaded, you will receive an email notification.
After downloading the zip archive, containing your Instagram data, you will have two options, depending on your use-case:

• Option 1: Run the application using GitHub Actions workflow
• Option 2: Run the application on your machine

Run the application using GitHub Actions workflow

• Upload the zip file, containing your Instagram data, to a cloud storage service. Afterward, generate a public link to the archive. The most common cloud storage service is probably Google Drive. Following the steps below will make your Instagram data archive publicly accessible:
  • Right-click your archive and open the Share menu
  • In the General access section use the dropdown menu and select Anyone with the link
  • Select role Viewer
  • Use the Copy link button to copy the public link to your archive
• Set up your repository
  • Fork the cecobask/instagram-insights repository to your account
  • Enable the insights workflow (help)
  • Create a new repository secret (help):
    • Name: ARCHIVE_URL
    • Secret: this must be equal to the value of your public archive url (previously copied)
• Run the insights workflow (help)
  • Shortly, check the console output of the workflow for results

Run the application on your machine

• Download and install Git + Go
• Clone the repository
• Build the application: make build
• Add the application to your path
• Load your Instagram data from a local zip file or cloud storage: instagram information load <source>
• Discover the available commands or browse through the documentation: instagram --help