Developer

Shots

List shots

GET /shots

Parameters

Name Type Description
list string Limit the results to a specific type with the following possible values:
  • animated
  • attachments
  • debuts
  • playoffs
  • rebounds
  • teams
Default: Results of any type.
timeframe string A period of time to limit the results to with the following possible values:
  • week
  • month
  • year
  • ever
Note that the value is ignored when sorting with recent.

Default: Results from now.
date date Limit the timeframe to a specific date, week, month, or year. Must be in the format of YYYY-MM-DD.
sort string The sort field with the following possible values:
  • comments
  • recent
  • views
Default: Results are sorted by popularity.

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
[
  {
    "id" : 471756,
    "title" : "Sasquatch",
    "description" : "<p>Quick, messy, five minute sketch of something that might become a fictional something.</p>",
    "width" : 400,
    "height" : 300,
    "images" : {
      "hidpi" : null,
      "normal" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch.png",
      "teaser" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch_teaser.png"
    },
    "views_count" : 4372,
    "likes_count" : 149,
    "comments_count" : 27,
    "attachments_count" : 0,
    "rebounds_count" : 2,
    "buckets_count" : 8,
    "created_at" : "2012-03-15T01:52:33Z",
    "updated_at" : "2012-03-15T02:12:57Z",
    "html_url" : "https://dribbble.com/shots/471756-Sasquatch",
    "attachments_url" : "https://api.dribbble.com/v1/shots/471756/attachments",
    "buckets_url" : "https://api.dribbble.com/v1/shots/471756/buckets",
    "comments_url" : "https://api.dribbble.com/v1/shots/471756/comments",
    "likes_url" : "https://api.dribbble.com/v1/shots/471756/likes",
    "projects_url" : "https://api.dribbble.com/v1/shots/471756/projects",
    "rebounds_url" : "https://api.dribbble.com/v1/shots/471756/rebounds",
    "animated" : false,
    "tags" : [
      "fiction",
      "sasquatch",
      "sketch",
      "wip"
    ],
    "user" : {
      "id" : 1,
      "name" : "Dan Cederholm",
      "username" : "simplebits",
      "html_url" : "https://dribbble.com/simplebits",
      "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
      "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
      "location" : "Salem, MA",
      "links" : {
        "web" : "http://simplebits.com",
        "twitter" : "https://twitter.com/simplebits"
      },
      "buckets_count" : 10,
      "comments_received_count" : 3395,
      "followers_count" : 29262,
      "followings_count" : 1728,
      "likes_count" : 34954,
      "likes_received_count" : 27568,
      "projects_count" : 8,
      "rebounds_received_count" : 504,
      "shots_count" : 214,
      "teams_count" : 1,
      "can_upload_shot" : true,
      "type" : "Player",
      "pro" : true,
      "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
      "followers_url" : "https://dribbble.com/v1/users/1/followers",
      "following_url" : "https://dribbble.com/v1/users/1/following",
      "likes_url" : "https://dribbble.com/v1/users/1/likes",
      "shots_url" : "https://dribbble.com/v1/users/1/shots",
      "teams_url" : "https://dribbble.com/v1/users/1/teams",
      "created_at" : "2009-07-08T02:51:22Z",
      "updated_at" : "2014-02-22T17:10:33Z"
    },
    "team" : {
      "id" : 39,
      "name" : "Dribbble",
      "username" : "dribbble",
      "html_url" : "https://dribbble.com/dribbble",
      "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/39/avatars/normal/apple-flat-precomposed.png?1388527574",
      "bio" : "Show and tell for designers. This is Dribbble on Dribbble.",
      "location" : "Salem, MA",
      "links" : {
        "web" : "http://dribbble.com",
        "twitter" : "https://twitter.com/dribbble"
      },
      "buckets_count" : 1,
      "comments_received_count" : 2037,
      "followers_count" : 25011,
      "followings_count" : 6120,
      "likes_count" : 44,
      "likes_received_count" : 15811,
      "members_count" : 7,
      "projects_count" : 4,
      "rebounds_received_count" : 416,
      "shots_count" : 91,
      "can_upload_shot" : true,
      "type" : "Team",
      "pro" : false,
      "buckets_url" : "https://dribbble.com/v1/users/39/buckets",
      "followers_url" : "https://dribbble.com/v1/users/39/followers",
      "following_url" : "https://dribbble.com/v1/users/39/following",
      "likes_url" : "https://dribbble.com/v1/users/39/likes",
      "members_url" : "https://dribbble.com/v1/teams/39/members",
      "shots_url" : "https://dribbble.com/v1/users/39/shots",
      "team_shots_url" : "https://dribbble.com/v1/users/39/teams",
      "created_at" : "2009-08-18T18:34:31Z",
      "updated_at" : "2014-02-14T22:32:11Z"
    }
  }
]

Get a shot

GET /shots/:id

Images

The normal image is typically 400x300, but may be smaller if created before October 4th, 2012. The width and height provide the size of the normal image.

The hidpi image may or may not be present, but will always be 800x600.

The teaser image is typically 200x150, but may be smaller if created before October 4th, 2012.

If the animated attribute of the shot is true, the highest resolution image available (hidpi or normal) will be animated (smaller images will be stills).

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 471756,
  "title" : "Sasquatch",
  "description" : "<p>Quick, messy, five minute sketch of something that might become a fictional something.</p>",
  "width" : 400,
  "height" : 300,
  "images" : {
    "hidpi" : null,
    "normal" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch.png",
    "teaser" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch_teaser.png"
  },
  "views_count" : 4372,
  "likes_count" : 149,
  "comments_count" : 27,
  "attachments_count" : 0,
  "rebounds_count" : 2,
  "buckets_count" : 8,
  "created_at" : "2012-03-15T01:52:33Z",
  "updated_at" : "2012-03-15T02:12:57Z",
  "html_url" : "https://dribbble.com/shots/471756-Sasquatch",
  "attachments_url" : "https://api.dribbble.com/v1/shots/471756/attachments",
  "buckets_url" : "https://api.dribbble.com/v1/shots/471756/buckets",
  "comments_url" : "https://api.dribbble.com/v1/shots/471756/comments",
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/likes",
  "projects_url" : "https://api.dribbble.com/v1/shots/471756/projects",
  "rebounds_url" : "https://api.dribbble.com/v1/shots/471756/rebounds",
  "animated" : false,
  "tags" : [
    "fiction",
    "sasquatch",
    "sketch",
    "wip"
  ],
  "user" : {
    "id" : 1,
    "name" : "Dan Cederholm",
    "username" : "simplebits",
    "html_url" : "https://dribbble.com/simplebits",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
    "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://simplebits.com",
      "twitter" : "https://twitter.com/simplebits"
    },
    "buckets_count" : 10,
    "comments_received_count" : 3395,
    "followers_count" : 29262,
    "followings_count" : 1728,
    "likes_count" : 34954,
    "likes_received_count" : 27568,
    "projects_count" : 8,
    "rebounds_received_count" : 504,
    "shots_count" : 214,
    "teams_count" : 1,
    "can_upload_shot" : true,
    "type" : "Player",
    "pro" : true,
    "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
    "followers_url" : "https://dribbble.com/v1/users/1/followers",
    "following_url" : "https://dribbble.com/v1/users/1/following",
    "likes_url" : "https://dribbble.com/v1/users/1/likes",
    "shots_url" : "https://dribbble.com/v1/users/1/shots",
    "teams_url" : "https://dribbble.com/v1/users/1/teams",
    "created_at" : "2009-07-08T02:51:22Z",
    "updated_at" : "2014-02-22T17:10:33Z"
  },
  "team" : {
    "id" : 39,
    "name" : "Dribbble",
    "username" : "dribbble",
    "html_url" : "https://dribbble.com/dribbble",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/39/avatars/normal/apple-flat-precomposed.png?1388527574",
    "bio" : "Show and tell for designers. This is Dribbble on Dribbble.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://dribbble.com",
      "twitter" : "https://twitter.com/dribbble"
    },
    "buckets_count" : 1,
    "comments_received_count" : 2037,
    "followers_count" : 25011,
    "followings_count" : 6120,
    "likes_count" : 44,
    "likes_received_count" : 15811,
    "members_count" : 7,
    "projects_count" : 4,
    "rebounds_received_count" : 416,
    "shots_count" : 91,
    "can_upload_shot" : true,
    "type" : "Team",
    "pro" : false,
    "buckets_url" : "https://dribbble.com/v1/users/39/buckets",
    "followers_url" : "https://dribbble.com/v1/users/39/followers",
    "following_url" : "https://dribbble.com/v1/users/39/following",
    "likes_url" : "https://dribbble.com/v1/users/39/likes",
    "members_url" : "https://dribbble.com/v1/teams/39/members",
    "shots_url" : "https://dribbble.com/v1/users/39/shots",
    "team_shots_url" : "https://dribbble.com/v1/users/39/teams",
    "created_at" : "2009-08-18T18:34:31Z",
    "updated_at" : "2014-02-14T22:32:11Z"
  }
}

Create a shot

POST /shots

Creating a shot requires the user to be authenticated with the upload scope. The authenticated user must also be a player or team.

Parameters

Name Type Description
title string Required. The title of the shot.
image file Required. The image file.

It must be exactly 400x300 or 800x600, no larger than eight megabytes, and be a GIF, JPG, or PNG.
description string A description of the shot.
tags array Tags for the shot.

Limited to a maximum of 12 tags.
team_id integer An ID of a team to associate the shot with.

The authenticated user must either be a member of the team or be authenticated as the same team.
rebound_source_id integer An ID of a shot that the new shot is a rebound of.

The shot must be reboundable and by a user not blocking the authenticated user.
low_profile boolean Specify true if the shot is Low Profile.

Response

Creating a shot happens asynchronously. After creation the returned location will return a 404 Not Found until processing is completed. If this takes longer than five minutes, be sure to contact support.

Status: 202 Accepted
Location: https://api.dribbble.com/v1/shots/471756
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59

Update a shot

PUT /shots/:id

Updating a shot requires the user to be authenticated with the upload scope. The authenticated user must also own the shot.

Parameters

Name Type Description
title string The title of the shot.
description string A description of the shot.
team_id integer An ID of a team to associate the shot with.

The authenticated user must be on the team. If any empty value is provided the team association will be removed.
tags array Tags for the shot.

Limited to a maximum of 12 tags. If any existing tags are not provided they will be removed.
low_profile boolean Specify true if the shot is Low Profile.

Example

{
  "title" : "Sasquatch",
  "description" : "Quick, messy, five minute sketch of something that might become a fictional something.",
  "team_id" : 39,
  "tags" : [
    "fiction",
    "sasquatch",
    "sketch",
    "wip"
  ]
}

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 471756,
  "title" : "Sasquatch",
  "description" : "<p>Quick, messy, five minute sketch of something that might become a fictional something.</p>",
  "width" : 400,
  "height" : 300,
  "images" : {
    "hidpi" : null,
    "normal" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch.png",
    "teaser" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch_teaser.png"
  },
  "views_count" : 4372,
  "likes_count" : 149,
  "comments_count" : 27,
  "attachments_count" : 0,
  "rebounds_count" : 2,
  "buckets_count" : 8,
  "created_at" : "2012-03-15T01:52:33Z",
  "updated_at" : "2012-03-15T02:12:57Z",
  "html_url" : "https://dribbble.com/shots/471756-Sasquatch",
  "attachments_url" : "https://api.dribbble.com/v1/shots/471756/attachments",
  "buckets_url" : "https://api.dribbble.com/v1/shots/471756/buckets",
  "comments_url" : "https://api.dribbble.com/v1/shots/471756/comments",
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/likes",
  "projects_url" : "https://api.dribbble.com/v1/shots/471756/projects",
  "rebounds_url" : "https://api.dribbble.com/v1/shots/471756/rebounds",
  "animated" : false,
  "tags" : [
    "fiction",
    "sasquatch",
    "sketch",
    "wip"
  ],
  "team" : {
    "id" : 39,
    "name" : "Dribbble",
    "username" : "dribbble",
    "html_url" : "https://dribbble.com/dribbble",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/39/avatars/normal/apple-flat-precomposed.png?1388527574",
    "bio" : "Show and tell for designers. This is Dribbble on Dribbble.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://dribbble.com",
      "twitter" : "https://twitter.com/dribbble"
    },
    "buckets_count" : 1,
    "comments_received_count" : 2037,
    "followers_count" : 25011,
    "followings_count" : 6120,
    "likes_count" : 44,
    "likes_received_count" : 15811,
    "members_count" : 7,
    "projects_count" : 4,
    "rebounds_received_count" : 416,
    "shots_count" : 91,
    "can_upload_shot" : true,
    "type" : "Team",
    "pro" : false,
    "buckets_url" : "https://dribbble.com/v1/users/39/buckets",
    "followers_url" : "https://dribbble.com/v1/users/39/followers",
    "following_url" : "https://dribbble.com/v1/users/39/following",
    "likes_url" : "https://dribbble.com/v1/users/39/likes",
    "members_url" : "https://dribbble.com/v1/teams/39/members",
    "shots_url" : "https://dribbble.com/v1/users/39/shots",
    "team_shots_url" : "https://dribbble.com/v1/users/39/teams",
    "created_at" : "2009-08-18T18:34:31Z",
    "updated_at" : "2014-02-14T22:32:11Z"
  }
}

Delete a shot

DELETE /shots/:id

Deleting a shot requires the user to be authenticated with the upload scope. The authenticated user must also own the shot.