Instagram Scraper Documentation

Last updated: April 2, 2017

Download

The download link is provided in the e-mail address you receive when you purchase the software. It also contains the license key which is required for activation later on.

Installation

Instagram Scraper does not require any special installation. After you have downloaded the software, all you have to do is extract the files to your computer. From there, you can immediately run the software.

Settings

Configuring the settings is a key part of the software before doing any other tasks, because some of them are dependent on them. Some of the settings are set up (randomized) by default, but can be modified at your choice. Having a valid Instagram account is required.

Logging in

Instagram does not allow to scrape users without being logged in, so the first step is to log in with a valid Instagram account. You could use a proxy, but it is not necessary. You should get a message "Status: Logged in" if you are logged in successfully.

screenshot

Advanced Settings

We allow you to edit some of the core settings of the software at your choice. By default, we provide valid details and option to randomize it. However, if you feel that you want to use custom details, you can do that as well.

We currently allow the following settings to be adjusted: Device ID, GUID and phone ID.

NOTE

These settings require to be VALID, so be careful when editing them. In case of invalid settings, Instagram might return invalid requests and hence no data will be scraped.

Output data

Before starting a scraping or filtering session, make sure to choose a valid directory for saving the output data.

Other

Instagram Scraper is a multi threaded software, which means that you can use multiple threads to scrape or filter data. You can adjust the threads in the settings.

Debug log scraps - debugs the data while scraping and generates a log file, which might be required when reporting bugs.

Autosave - automatically saves the session and continues where it stopped when you scrape next time.

Scraper

Using the scraper, you can scrape users and filter them on-the-fly (limited filtering settings). There are multiple input types, as well as output types. For more detailed filter, use our filterer tool instead.

screenshot

Scraper options

User status - allows you to filter users on-the-fly based on their status.

Profile picture - allows you to filter users on-the-fly based on their profile picture.

Store as - choose what type of data to save in the output file. If chosen usernames, it will save usernames of the scraped users. If chosen user IDs, it will save their IDs.

Controls and stats

In this box you can see the performance of the software as well as some other statistics.

"Running for:" - shows how long you have been scraping for.

"Scraped" - shows the total amount of scraped users.

"Skipped" - shows the amount of skipped/ignored users. These are duplicate or filtered users.

Input data

Input data is the parameters which the scraper takes and searches for users based on them. Currently we support the following input types:

  • User's followings - users which are being followed by a specific users
  • User's followers - users which are following a specific person
  • Hashtags - users who posted in a specific hashtag
  • Locations - users who tagged themselves in a specific location
  • Users Who Liked - users who liked a specific photo
  • Users Who Commented - users who commented a specific photo

There are two ways to add input data

  • Load - by loading them from a file (one per line)
  • Add - by adding them one by one manually

You can see the input data in a table on the GUI and modify it.

Filter

Using the filter tool, you can filter a list of users. The filter tool outputs two files, one with the filtered users and the other one with the non-filtered (leftovers). They are saved in the directory you choose in the settings.

Preview of the filter tool:

screenshot
screenshot
screenshot

Filter #1

User filters

  • Followers - filter users who are being followed by a specific amount of people
  • Media (uploads) - filter users who have specific amount of medias uploaded on their account
  • Followings - filter users who are following a specific amount of people
  • Verified - filter users who have a verified Instagram account
  • Website - filter users with a website URL in their profile
  • Last upload - filter users who have last been active at a certain date
  • Store as - choose how to store the filtered users (user ID, usernames or extract e-mail address(es) (if any))

Controls and stats

  • "Running for:" - shows how long you have been filtering for.
  • "Filtered" - shows the total amount of filtered users.
  • "Skipped" - shows the amount of skipped/ignored users. These are duplicate or users who do not meet the filtering criteria.

Input files

The filter tool filters users loaded from a file. You can choose the input type (usernames or user IDs) and press "Add files" to load the file(s). The format for the file(s) is one username or user ID per line.

Filter #2

  • Name has to contain one of those words - filter users whose name contains at least one of the inputted words (one word per line)
  • Name can't contain any of those words - filter users whose name can't contain any of the inputted words (one word per line)
  • Bio has to contain one of those words - filter users who contain at least one of the inputted words (one word per line)
  • Bio can't contain any of those words - filter users whose bio can't contain any of the inputted words (one word per line)

Filter #3

  • Username has to contain one of those words - filter users whose username contains at least one of the inputted words (one word per line)
  • Username can't contain any of those words - filter users whose username can't contain any of the inputted words (one word per line)

Updates

Instagram Scraper checks for a new update automatically when you start the software. If there is a new update, it will ask if you want to update or not.

You can also update the software by clicking the "Update" label on the top-right.