Skip to content
Python script to download Instagram stories from Instagram users.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Show if user to download is private and not being followed Jun 20, 2019
LICENSE Initial commit May 18, 2018 Bump version to 2.5 Jul 13, 2019 Add retry to user download on fail Jul 27, 2019


Version 2.5 Python 2.7, 3.5

Support me!

Python script to download Instagram stories from a single user or multiple users at once. Supports Python 2.7 and 3.5.

How to use

Make sure you have the following dependency installed:


The --username and --password arguments are required to generate a new cookie file or when an existing cookie file has expired. You can omit these two arguments if there is a working login cookie file available already.

--download — User(s) to download. Multiple users must be seperated by a space.

--batch-file — Download stories from usernames in a text file.

--taken-at — PyInstaStories will save files with a datetime format: 2019-01-07_22-51-43.jpg

--no-thumbs — PyInstaStories will skip downloadable video story thumbnail images.

--hq-videos — PyInstaStories will download slightly higher quality video stories. Requires ffmpeg. Not stable right now.


Download stories of 3 users.
python3 -d jacobsartorius justinbieber lilhankwilliams

Download stories of 1 user. Save files with a datetime format and skip downloading of video thumbnail images.
python3 -d iamcardib --taken-at --no-thumbs

Download stories from a text file. Pass login username and password as arguments.
python3 --batch-file usernames.txt --username johndoe --password grapefruits

Example terminal output
$ python3 --download justinbieber
[I] PYINSTASTORIES (SCRIPT V2.1 - PYTHON V3.7.3) - 05:55:42 PM
[I] Using cached login cookie for "johndoe".
[I] Login to "johndoe" OK!
[I] Login cookie expiry date: 2019-08-07 at 09:54:43 PM
[I] Files will be downloaded to C:\Users\User\Documents\Git\PyInstaStories
[I] Getting stories for: justinbieber
[I] Downloading video stories. (7 stories detected)
[I] (1/7) Downloading video: 41107421_150110362713394_6909049832863331499_n.mp4
[I] (2/7) Downloading video: 40704767_352431668802214_7535329190798115834_n.mp4
[I] (3/7) Downloading video: 32675407_899984993677896_5838612576283769538_n.mp4
[I] (4/7) Downloading video: 27460743_1232788393557486_4163271676685655927_n.mp4
[I] (5/7) Downloading video: 40991261_591854457989117_3573059593419810351_n.mp4
[I] (6/7) Downloading video: 27449739_373199263333116_2195630862018446526_n.mp4
[I] (7/7) Downloading video: 32786476_689302061513389_6323122299924594750_n.mp4
[I] Downloading image stories. (3 stories detected)
[I] (1/3) Downloading image: 61787819_1607274159404970_4836984492900662152_n.jpg
[I] (2/3) Downloading image: 64505667_498208200986305_7034972402491620659_n.jpg
[I] (3/3) Downloading image: 64264791_1350148401799309_7365462912390446749_n.jpg
[I] Story downloading ended with 3 new images and 7 new videos downloaded.
You can’t perform that action at this time.