instaloader

Simple downloader to fetch all Instagram pictures and captions from a given profile.

Usage

Ensure having Python (at least version 3.3) and python3-requests installed.

After having downloaded instaloader.py, you invoke it with

instaloader.py profile [profile ...]

where profile is the name of a profile you want to download. Instead of only one profile, you may also specify a list of profiles.

To later update your local copy of that profile, you may run

instaloader.py --fast-update profile [profile ...]

When --fast-update is given, instaloder terminates when arriving at the first already-downloaded picture.

Instaloader can also be used to download private profiles. To do so, invoke it with

instaloader.py --login username profile [profile ...]

When invoked like this, it also stores the session cookies in a file in /tmp, which will later be reused when --login is given. So you can download private profiles non-interactively when you already have a valid session cookies file.

The --quiet option makes it also suitable as a cron job.

To get a list of other helpful flags, run instaloader.py --help.

Usage as library

You may also use parts of instaloader as library to do other interesting things.

For example, to get a list of all followers of a profile as well as their follower count, do

import instaloader

# login
session = instaloader.get_logged_in_session(USERNAME)

# get followees
followees = instaloader.get_followees(PROFILES, session)
for f in followees:
    print("%i\t%s\t%s" % (f['follower_count'], f['username'], f['full_name']))

Then, you may download all pictures of all followees with

for f in followees:
    try:
        instaloader.download(f['username'], session)
    except instaloader.NonfatalException:
        pass