Instaloader

Instaloader is a tool to download pictures (or videos) along with their captions and other metadata from Instagram.

With Python installed, do:

$ pip3 install instaloader

$ instaloader profile [profile ...]

See Install Instaloader for more options on how to install Instaloader.

Instaloader

• downloads public and private profiles, hashtags, user stories, feeds and saved media,

• downloads comments, geotags and captions of each post,

• automatically detects profile name changes and renames the target directory accordingly,

• allows fine-grained customization of filters and where to store downloaded media,

• automatically resumes previously-interrupted download iterations,

• is free open source software written in Python.

instaloader [--comments] [--geotags]
            [--stories] [--highlights] [--tagged] [--reels] [--igtv]
            [--login YOUR-USERNAME] [--fast-update]
            profile | "#hashtag" | %location_id |
            :stories | :feed | :saved

See Download Pictures from Instagram for a detailed introduction on how to use Instaloader to download pictures from Instagram.

Instaloader Documentation

• Install Instaloader
• Download Pictures from Instagram
  • Basic Usage
  • What to Download
  • Filename Specification
  • Filter Posts
  • Metadata Text Files
  • Exit codes
  • Instaloader as Cronjob
  • Programming Instaloader
• Command Line Options
  • Targets
  • What to Download of each Post
  • What to Download of each Profile
  • Which Posts to Download
  • Login (Download Private Profiles)
  • How to Download
  • Miscellaneous Options
• Python Module instaloader
  • Instaloader (Main Class)
  • Instagram Structures
  • Resumable Iterations
  • InstaloaderContext (Low-level functions)
  • Exceptions
• Advanced Instaloader Examples
  • Download Posts in a Specific Period
  • Likes of a Profile / Ghost Followers
  • Track Deleted Posts
  • Only one Post per User
  • Top X Posts of User
  • Metadata JSON Files
• Troubleshooting
  • 429 Too Many Requests
  • Too many queries in the last time
  • Private but not followed
  • Login error
• Contributing to Instaloader
  • Answering Questions
  • Reporting Bugs
  • Writing Code or Improving the Documentation
  • Proposing Features
  • Sponsoring

Useful Links

• Git Repository (on GitHub)

• PyPI Project Page

• Issue Tracker / Bug Tracker

• Version History

Contributing

As an open source project, Instaloader heavily depends on the contributions from its community. See Contributing to Instaloader for how you may help Instaloader to become an even greater tool.

Supporters

Instaloader is proudly sponsored by

@rocketapi-io

See Alex’ GitHub Sponsors page for how you can sponsor the development of Instaloader!

It is a pleasure for us to share our Instaloader to the world, and we are proud to have attracted such an active and motivating community, with so many users who share their suggestions and ideas with us. Buying a community-sponsored beer or coffee from time to time is very likely to further raise our passion for the development of Instaloader.

For Donations, we provide GitHub Sponsors page, a PayPal.Me link and a Bitcoin address.

GitHub Sponsors: Sponsor @aandergr on GitHub Sponsors

PayPal: PayPal.me/aandergr

BTC: 1Nst4LoadeYzrKjJ1DX9CpbLXBYE9RKLwY

Disclaimer

Instaloader is in no way affiliated with, authorized, maintained or endorsed by Instagram or any of its affiliates or subsidiaries. This is an independent and unofficial project. Use at your own risk.

Instaloader is licensed under an MIT license. Refer to LICENSE file for more information.