Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


    Dribbble Api 0.0.3

    What's this?

    This is a node module, serving as Dribbble API wrapper. See the Dribbble API docs for more details.


    The easiest way to install is via npm

    npm install dribbble-api

    Otherwise, you can install this is by taking the code and sticking it in your node_modules folder.


    Dribbble doesn't (yet) require any sort of auth key or access token. Still, this module is a constructor. This way, if things change and keys are required, the constructor would be utilized and legacy code would be less effected.

    Making a request looks something like this:

    var dribbbleApi = require('dribbble-api')
    var dribbble = new dribbbleApi()
    dribbble.list('debuts', function(err, res, json, paging) { })

    Every callback gets four arguments; An error (if there is one), the HTTP response, a JSON object (probably what you will want) and a paging object (more on this in the paging section).


    All of the player-related functions require a player id (or username).

    Player Profile

    dribbble.player('44656', function(err, res, json, paging) {

    A Player's Shots

    dribbble.playerShots('44656', function(err, res, json, paging) {
        console.log(json) // json.shots

    Shots by Users Player is Following

    dribbble.playerFollowingShots('44656', function(err, res, json, paging) {
        console.log(json) // json.shots

    Shots Liked by Player

    dribbble.playerLikes('44656', function(err, res, json, paging) {
        console.log(json) // json.shots

    Users that Follow the Player

    dribbble.playerFollowers('44656', function(err, res, json, paging) {
        console.log(json) // json.players

    Users that the Player Follows

    dribbble.playerFollows('44656', function(err, res, json, paging) {
        console.log(json) // json.players

    Users Drafted by the Player

    dribbble.playerDraftees('44656', function(err, res, json, paging) {
        console.log(json) // json.players


    All of the shot-related functions, except for list, require a shot id.

    An Individual Shot's Profile

    dribbble.shot('300230', function(err, res, json, paging) {

    Rebounds of a Shot

    dribbble.shotRebounds('43424', function(err, res, json, paging) {
        console.log(json)  // json.shots

    Comments on a Shot

    dribbble.shotComments('43424', function(err, res, json, paging) {
        console.log(json)  // json.comments

    Lists of Shots

    This one is a bit different. It doesn't take a shot id. Instead it takes the name of a list.

    Possible names are popular, debuts and everyone.

    If you don't pass a list name it will default to popular.

    dribbble.list('popular', function(err, res, json, paging) {
        console.log(json)  // json.shots
    // has the same effect as
    dribbble.list(function(err, res, json, paging) {
        console.log(json)  // json.shots


    Dribbble allows for options to be set. You can set these by passing your options, as an {} object, just before the callback.

    dribbble.lists('debuts', { per_page: 30, page: 5 }, function(err, res, json, paging) { })


    The paging object returned to the callbacks may contain a next or previous function. These functions allow you to make another request, using the same arguments passed before, but with a new callback.

    Here's an example where we request as many pages as we can, from the 'popular list', and add all resulting shots to the popularShots array. Once this is done we'll call onRequestsFinished.

    var popularShots = []
    var onRequestsFinished = function() {
        // do something
    var requestCallback = function(err, res, json, paging) {
        if (Array.isArray(json.shots)) {
            popularShots = popularShots.concat(json.shots)
        if ( {
        else {
    dribbble.list('popular', requestCallback)

    Future Plans




    npm i dribbble-api

    Downloadsweekly downloads








    last publish


    • avatar