2016-07-28 17:24:38 +02:00
|
|
|
# instaloader
|
|
|
|
|
|
|
|
Simple downloader to fetch all Instagram pictures and captions from a given profile.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
Ensure having [Python](https://www.python.org/) (at least version 3.3) and
|
|
|
|
[python3-requests](https://pypi.python.org/pypi/requests/) installed.
|
|
|
|
|
|
|
|
After having downloaded instaloader.py, you invoke it with
|
|
|
|
```
|
2016-07-28 17:33:57 +02:00
|
|
|
./instaloader.py profile [profile ...]
|
2016-07-28 17:24:38 +02:00
|
|
|
```
|
|
|
|
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
|
|
|
|
```
|
2016-07-28 17:33:57 +02:00
|
|
|
./instaloader.py --fast-update profile [profile ...]
|
2016-07-28 17:24:38 +02:00
|
|
|
```
|
|
|
|
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
|
|
|
|
```
|
2016-07-28 17:33:57 +02:00
|
|
|
./instaloader.py --login=your_username profile [profile ...]
|
2016-07-28 17:24:38 +02:00
|
|
|
```
|
2016-07-28 17:33:57 +02:00
|
|
|
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 cookies file.
|
2016-07-28 17:24:38 +02:00
|
|
|
|
|
|
|
The `--quiet` option makes it also **suitable as a cron job**.
|
|
|
|
|
2016-07-28 17:33:57 +02:00
|
|
|
To get a list of other helpful flags, run `./instaloader.py --help`.
|
2016-07-28 17:24:38 +02:00
|
|
|
|
|
|
|
## 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
|
|
|
|
```python
|
|
|
|
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
|
|
|
|
```python
|
|
|
|
for f in followees:
|
|
|
|
try:
|
|
|
|
instaloader.download(f['username'], session)
|
|
|
|
except instaloader.NonfatalException:
|
|
|
|
pass
|
|
|
|
```
|