A simple Python wrapper for the Dribbble API
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
dribbble return json response properly Dec 6, 2013
README.md Add Travis build status to README Jul 9, 2012
setup.py Bump version to 0.3 Dec 6, 2013
test.py Add tests Jul 9, 2012



Build Status

A simple Python wrapper for the Dribbble API.


The easiest way to get the API is by using pip:

pip install dribbble


The dribbble wrapper intends to make the API as easy to use as possible.

>>> import dribbble as d

# Get info on a player
>>> d.info('simplebits')

# Alternative, cooler name for getting info
>>> d.scout('simplebits')

# See the current community shots
>>> d.shots('popular')
>>> d.shots('everyone')
>>> d.shots('debut')

# Pagination and up to 30 shots at a time.
>>> d.shots('popular', count=30, page=2)

# Get shots for a player
>>> d.shots('simplebits')
>>> d.player('simplebits')

# Get information on a particular shot
>>> d.shot(1234)

# See a particular shot's rebounds
>>> d.rebounds(591065)

# Get comments on a shot
>>> d.comments(607332)

# See the likes for a player
>>> d.likes('simplebits')

# Get the followers of a player
>>> d.followers('lobanovskiy')

# See who a player is following
>>> d.following('simplebits')
>>> d.teammates('vi')

# Get recent shots from the players a player is following
>>> d.scoreboard('simplebits')

# See who a given player has drafted
>>> d.draftees('CreatureBox')

# Get the Twitter username of a player
>>> d.twitter('vi')

If you have lxml installed, there are two additional functions, as well.

# Check to see if a shot has attachments
>>> d.attachments(535565)

# See if a shot has PSD attachments
>>> d.psd(607070)