You're looking at the new v2 API docs. If you're maintaining an existing v1 API app, you may want to see the v1 docs instead.

Media Types

Custom media types are used in the API to let consumers choose the format of the data they wish to receive. This is done by adding one of the following types to the Accept header when you make a request. Media types are specific to resources, allowing them to change independently and support formats that other resources don’t.

A version is currently required and only supports v2, but may change in the future. All Dribbble media types look like this:


Shot Description Property

The description of a shot can be written with some HTML, such as links, and may include auto-linked URLs and username mentions.


Returns HTML rendered from the body, which includes auto-linking URLs and username mentions. Response will include a description attribute. This is the default if you do not pass any specific media type.



Returns a mostly text representation of the description, which is what we display in a textarea when a user is editing a description. It may contain some HTML if the user provided any, but no auto-linking or mention links will be included. Response will include a description_text attribute.