instaloader

Download pictures (or videos) along with their captions and other metadata from Instagram.

Github stars Tracking Chart

.. image:: https://raw.githubusercontent.com/instaloader/instaloader/master/docs/logo_heading.png

.. badges-start, travis, pypi, pyversion, license, aur, contributors, downloads, saythanks, .., travis, image:: https://img.shields.io/travis/instaloader/instaloader/master.svg
:alt: Travis-CI Build Status
:target: https://travis-ci.org/instaloader/instaloader

.., pypi, image:: https://img.shields.io/pypi/v/instaloader.svg
:alt: Instaloader PyPI Project Page
:target: https://pypi.org/project/instaloader/

.., license, image:: https://img.shields.io/github/license/instaloader/instaloader.svg
:alt: MIT License
:target: https://github.com/instaloader/instaloader/blob/master/LICENSE

.., pyversion, image:: https://img.shields.io/pypi/pyversions/instaloader.svg
:alt: Supported Python Versions

.., contributors, image:: https://img.shields.io/github/contributors/instaloader/instaloader.svg
:alt: Contributor Count
:target: https://github.com/instaloader/instaloader/graphs/contributors

.., saythanks, image:: https://img.shields.io/badge/Say%20Thanks-!-ff7efd.svg
:alt: Say Thanks!
:target: https://saythanks.io/to/aandergr

.., aur, image:: https://img.shields.io/aur/version/instaloader.svg
:alt: Arch User Repository Package
:target: https://aur.archlinux.org/packages/instaloader/

.., downloads, image:: https://img.shields.io/pypi/dm/instaloader.svg
:alt: PyPI Download Count

.. badges-end

::

$ pip3 install instaloader

$ instaloader profile [profile ...]

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.

::

instaloader [--comments] [--geotags] [--stories] [--highlights] [--tagged]
            [--login YOUR-USERNAME] [--fast-update]
            profile, "#hashtag", :stories, :feed, :saved

Instaloader Documentation <https://instaloader.github.io/>__

How to Automatically Download Pictures from Instagram

To download all pictures and videos of a profile, as well as the
profile picture, 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 profiles, you may run

::

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

If --fast-update is given, Instaloader stops when arriving at the
first already-downloaded picture. When updating profiles, Instaloader
automatically detects profile name changes and renames the target directory
accordingly.

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

::

instaloader --login=your_username profile [profile ...]

When logging in, Instaloader stores the session cookies in a file in your
temporary directory, which will be reused later the next time --login
is given. So you can download private profiles non-interactively when you
already have a valid session cookie file.

Instaloader Documentation <https://instaloader.github.io/basic-usage.html>__

Disclaimer

.. disclaimer-start

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.

.. disclaimer-end

Contributing

As an open source project, Instaloader heavily depends on the contributions from
its community. See
contributing <https://instaloader.github.io/contributing.html>__
for how you may help Instaloader to become an even greater tool.

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 a PayPal.Me link and a Bitcoin address., PayPal: PayPal.me/aandergr <https://www.paypal.me/aandergr>__, BTC: 1Nst4LoadeYzrKjJ1DX9CpbLXBYE9RKLwY

Main metrics

Overview
Name With Ownerinstaloader/instaloader
Primary LanguagePython
Program languagePython (Language Count: 2)
Platform
License:MIT License
所有者活动
Created At2016-06-15 10:40:37
Pushed At2025-01-29 07:14:19
Last Commit At2025-01-24 08:19:13
Release Count141
Last Release Namev4.14.1 (Posted on 2025-01-24 08:21:18)
First Release Namev1.0 (Posted on )
用户参与
Stargazers Count9.7k
Watchers Count169
Fork Count1.3k
Commits Count0.9k
Has Issues Enabled
Issues Count2268
Issue Open Count74
Pull Requests Count121
Pull Requests Open Count7
Pull Requests Close Count126
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private