A simple Python library for the Instagram Basic Display API. Based on the instagram-basic-display-php by espresso.dev

PyPI package available.

• Python3.6 or better
• python-requests
• Facebook Developer Account
• Facebook App

To use the Instagram Basic Display API, you will need to register a Facebook app and configure Instagram Basic Display. Follow the getting started guide.

I strongly advice using PyPI to keep updates as smooth as possible.

$ pip3 install instagram-basic-display

from instagram_basic_display.InstagramBasicDisplay import InstagramBasicDisplay

instagram_basic_display = InstagramBasicDisplay(app_id='YOUR_APP_ID', app_secret='YOUR_APP_SECRET', redirect_url='YOUR_APP_REDIRECT_URI')

print(instagram_basic_display.get_login_url()) # Returns login URL you need to follow

# Get the OAuth callback code
code = request.args.get('code')

# Get the short lived access token (valid for 1 hour)
short_lived_token = instagram_basic_display.get_o_auth_token(code)

# Exchange this token for a long lived token (valid for 60 days)
long_lived_token = instagram_basic_display.get_long_lived_token(short_lived_token.get('access_token'))

print('Your token is: {}' .format(long_lived_token.access_token))

# Set user access token
instagram_basic_display.set_access_token(long_lived_token.access_token)

# Get the users profile
profile = instagram_basic_display.get_user_profile()

print(profile)

Instagram(app_id: str, app_secret: str, redirect_url: str)

get_login_url(scopes: list=None)

get_o_auth_token(code: str)

get_long_lived_token(access_token)

refresh_token(access_token)

• Set the access token, for further method calls: set_access_token($token)
• Get the access token, if you want to store it for later usage: get_access_token()

Authenticated methods

• get_user_profile()
• get_user_media(user_id='me', limit: int = None, before: int = None, after: int = None)
  • if an user_id isn't defined or equals 'me', it returns the media of the logged in user

Authenticated methods

• get_media(_id: int)
• get_media_children(_id: int)

The get_user_media endpoint has a maximum range of results, so increasing the limit parameter above the limit of 99 won't help.You can use pagination to return more results for this endpoint.

Pass an object into the pagination() method and receive your next dataset:

media = instagram_basic_display.get_user_media()

more_media = instagram_basic_display.pagination(media)