In this brief tutorial I’ll be going over some of the basic concepts for developing over the Dribbble API. We will be focusing on PHP as the main programming language. This is causal to the fact PHP is supported in nearly every environment and it offers a very small learning curve for newbie developers.

Examining the API

In all truth It’s not a difficult sight to go through. In fact, Dribbble’s official documentation offers some great constructs into the powerful network of design shots.

When preparing for this type of project it’s key to consider a wrapper or library to work around. This saves us a load of time since we don’t need to re-create the most common functionality found within the API. The various libraries openly available through GitHub is another reason why PHP makes a great choice for the backend dev language.


For our example we can go through Martin Bean’s Dribbble wrapper to find exactly what we’re trying to do. You should download the most recent version and extract all the files into an open directory. Inside you’ll find two folders examples and src. It may be straightforward but “examples” will contain a few common implementations for function calls while “src” includes all of the files we need for a new project.

Working with our PHP Wrapper

Now that we’ve got everything settled we should create our application directory. At this point you’ll want to create a new project directory either on a locally installed version of Apache or in a remote web server.

WAMP and MAMP are still today the best options for all-in-one install packages. These include Apache as a web server with PHP/MySQL support for backend functionality. Once installed you’ll be working within a root www directory – this should hold all your server files.

I’ve created a new folder titled “dribble1” and moved the entire “src” folder into this. Also inside of our “dribble1” folder I’ve created a new file index.php which we can use to store all of our example code. You can structure your hierarchy in any way you’d like, just be sure all the src files are kept together and can be accessed from your project.

Including Headers

At the very top of your new index.php file it’s important to include the following code bits. These are used to create a connection into the wrapper package we downloaded.

$dribbble = new Dribbble();