This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Installation

instaloader is written in Python, thus ensure having Python (at least version 3.3) installed.

If you intend to use this tool under Windows, it is recommended to install win-unicode-console.

If you have pip installed, you may install instaloader using

pip3 install instaloader

Alternatively, you may download instaloader from github, unzip it and invoke bundled setup.py (requiring setuptools) to install it:

python3 setup.py install [--user]

(pass --user to install it for your user only instead of globally)

instaloader requires requests, which will be installed automatically by setup.py, if not already installed.

How to automatically download pictures from Instagram

To download a set of profiles, do

instaloader 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 --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 --login=your_username profile [profile ...]

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

If you want to download all followees of a given profile, call

instaloader --login=your_username @profile

To download all the pictures from your feed which you have liked, call

instaloader --login=your_username :feed-liked

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

To get a list of other helpful flags, run instaloader --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(PROFILE, 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

You could also download your last 20 liked pics with

instaloader.download_feed_pics(session, max_count=20, fast_update=True,
                               filter_func=lambda node: not node["likes"]["viewer_has_liked"])

Each Instagram profile has its own unique ID which stays unmodified even if a user changes his/her username. To get said ID, given the profile’s name, you may call

instaloader.get_id_by_username(PROFILE_NAME)

get_followees() also returns unique IDs for all loaded followees. To get the current username of a profile, given this unique ID get_username_by_id() can be used. For example:

instaloader.get_username_by_id(session, followees[0]['id'])
Release History

Release History

1.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
instaloader-1.2-py3.5.egg (24.0 kB) Copy SHA256 Checksum SHA256 3.5 Egg Sep 22, 2016
instaloader-1.2.tar.gz (12.9 kB) Copy SHA256 Checksum SHA256 Source Sep 22, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting