Instagram Private API
A Python wrapper for the Instagram private API with no 3rd party dependencies. Supports both the app and web APIs.
![Build](https://img.shields.io/travis/ping/instagram_private_api.svg)
![Build](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)
Overview
I wrote this to access Instagram's API when they clamped down on developer access. Because this is meant to achieve parity with the official public API, methods not available in the public API will generally have lower priority.
Problems? Please check the docs before submitting an issue.
Features
- Supports many functions that are only available through the official app, such as:
- The web api client supports a subset of functions that do not require login, such as:
- Compatible with functions available through the public API using the ClientCompatPatch (app/web) utility class
- Beta Python 3 support
An extension module is available to help with common tasks like pagination, posting photos or videos.
Documentation
Documentation is available at https://instagram-private-api.readthedocs.io/en/latest/
Install
Install with pip:
pip install git+https://git@github.com/ping/instagram_private_api.git@1.6.0
To update:
pip install git+https://git@github.com/ping/instagram_private_api.git@1.6.0 --upgrade
To update with latest repo code:
pip install git+https://git@github.com/ping/instagram_private_api.git --upgrade --force-reinstall
Tested on Python 2.7 and 3.5.
Usage
The app API client emulates the official app and has a larger set of functions. The web API client has a smaller set but can be used without logging in.
Your choice will depend on your use case.
The examples/
and tests/
are a good source of detailed sample code on how to use the clients, including a simple way to save the auth cookie for reuse.
from instagram_private_api import Client, ClientCompatPatch
user_name = 'YOUR_LOGIN_USER_NAME'
password = 'YOUR_PASSWORD'
api = Client(user_name, password)
results = api.feed_timeline()
items = [item for item in results.get('feed_items', [])
if item.get('media_or_ad')]
for item in items:
ClientCompatPatch.media(item['media_or_ad'])
print(item['media_or_ad']['code'])
from instagram_web_api import Client, ClientCompatPatch, ClientError, ClientLoginError
web_api = Client(auto_patch=True, drop_incompat_keys=False)
user_feed_info = web_api.user_feed('329452045', count=10)
for post in user_feed_info:
print('%s from %s' % (post['link'], post['user']['username']))
authed_web_api = Client(
auto_patch=True, authenticate=True,
username='YOUR_USERNAME', password='YOUR_PASSWORD')
following = authed_web_api.user_following('123456')
for user in following:
print(user['username'])
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.
Donate
Want to keep this project going? Please donate generously https://www.buymeacoffee.com/ping
![Build](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)
Support
Make sure to review the contributing documentation before submitting an issue report or pull request.
Legal
Disclaimer: This is not affliated, endorsed or certified by Instagram. This is an independent and unofficial API. Strictly not for spam. Use at your own risk.