Skip to main content

Another API-less Instagram pictures and videos downloader

Project description

Not all treasure’s silver and gold, mate.

build repo versions format coverage doc grade license keepachangelog saythanks

InstaLooter is a program that can download any picture or video associated from an Instagram profile, without any API access. It can be seen as a re-implementation of the now deprecated InstaRaider developed by @akurtovic.

v1.0.0 was completely rewrote from scratch, and as such, will probably break compatibility with your homemade scripts. Meanwhile, great care was taken to keep the CLI as consistent as possible with the previous versions, so it’ll hopefully feel like home.



Colored output

PyPI coloredlogs

Source coloredlogs

License coloredlogs


Date manipulation

PyPI dateutil

Source dateutil

License dateutil


CLI arguments parsing

PyPI docopt

Source docopt

License docopt


Filesystem handling

PyPI fs

Source fs

License fs


HTTP handling

PyPI requests

Source requests

License requests


Python 2/3 compatibility

PyPI six

Source six

License six


Retry until success

PyPI tenacity

Source tenacity

License tenacity


Dynamic output in CLI

PyPI tqdm

Source tqdm

License tqdm


More detailed logs

PyPI verboselogs

Source verboselogs

License verboselogs


InstaLooter is available on PyPI to install with pip. If you are not familiar with the package management of the Python ecosystem, please see the Installation page of the documentation. Yet, you will probably end up using the following command:

pip install --user instalooter --pre


instalooter comes with its CLI:

$ instalooter user <username> [<directory>] [options]
$ instalooter hashtag <hashtag> [<directory>] [options]
$ instalooter post <post_token> [<directory>] [options]
$ instalooter batch [<batch_file>]

See instalooter --usage for all possible uses, or instalooter --help for a complete usage guide.

Logging in and out

There are two ways to login on Instagram through instalooter:

  • use the login subcommand (instalooter login) to interactively login using your username and password.

  • give a --username (and, if you want, a --password) argument to any of the download commands.

In both cases, a session cookie will be created in a cache-specific folder. To delete it and close your session on the server, use the logout subcommand.


Download all pictures from the instagram profile in the current directory:

$ instalooter user instagram

Download the latest 20 pictures or videos tagged with python to /tmp:

$ instalooter hashtag python /tmp -n 20 --get-videos -c MYLOGIN

Download a single post from an url in the ~/Pictures directory:

$ instalooter post "" ~/Pictures

Use a configuration file to download from several account using custom parameters (see Batch mode):

$ instalooter batch /path/to/a/config/file.ini

See more on the Usage page of the online documentation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

instalooter-2.4.4.tar.gz (450.6 kB view hashes)

Uploaded source

Built Distribution

instalooter-2.4.4-py2.py3-none-any.whl (45.6 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page