Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python Client for Instagram API
branch: master

This branch is 105 commits behind Instagram:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
fixtures
instagram
.gitignore
README.md
get_access_token.py
sample_app.py
setup.py
tests.py

README.md

python-instagram

A Python client for the Instagram REST and Search APIs

Installation

pip install python-instagram

Requires

  • httplib2
  • simplejson

Discussion

Visit our Google Group to discuss the Instagram API.

Obtaining an access token

You can use the provided get_access_token.py script to obtain an access token for yourself. It will prompt you for your app's Client ID, Client Secret, and Redirect URI, and walk you through instructions for getting your own access token for your app.

Usage

from instagram.client import InstagramAPI

access_token = "..."
api = InstagramAPI(access_token=access_token)
popular_media = api.media_popular(count=20)
for media in popular_media:
    print media.images['standard_resolution'].url

Sample app

We also provide a one-file sample app using bottle (you'll have to 'pip install bottle' first). To try it out:

  • Set your redirect URI to 'http://localhost:8515/oauth_callback' in your dev profile
  • Open up sample_app.py, update it with your client_id and secret, and set redirect URI to 'http://localhost:8515/oauth_callback'
  • Run the file; it will host a local server on port 8515.
  • Try visiting http://localhost:8515 in your browser
Something went wrong with that request. Please try again.