Install via pip

$ pip install instapi

Update your install with the latest release

$ pip install instapi --upgrade

Force an update from source

$ pip install instapi --upgrade --force-reinstall

Source Code

The library is maintained on GitHub. Feel free to clone the repository.

git clone git://


The private app API client emulates the official app and has a larger number of functions.


from instapi import Client, ClientCompatPatch

user_name = 'YOUR_LOGIN_USER_NAME'
password = 'YOUR_PASSWORD'

api = Client(user_name, password)
results = api.feed_timeline()
items = results.get('items', [])
for item in items:
    # Manually patch the entity to match the public api as closely as possible, optional
    # To automatically patch entities, initialise the Client with auto_patch=True

Avoiding Re-login

You are advised to persist/cache the auth cookie details to avoid logging in every time you make an api call. Excessive logins is a surefire way to get your account flagged for removal. It’s also advisable to cache the client details such as user agent, etc together with the auth details.

The saved auth cookie can be reused for up to 90 days.

An example of how to save and reuse the auth setting can be found in the examples.