Developer

You're looking at the deprecated v1 API docs. API v1 will be retired on March 26, 2018. You’ll eventually want to use the v2 docs instead.

Comments

List comments for a shot

GET /shots/:shot/comments

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
[
  {
    "id" : 1145736,
    "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
    "likes_count" : 1,
    "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
    "created_at" : "2012-03-15T04:24:39Z",
    "updated_at" : "2012-03-15T04:24:39Z",
    "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"
    }
  }
]

List likes for a comment

GET /shots/:shot/comments/:id/likes

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
[
  {
    "id" : 24400091,
    "created_at" : "2014-01-06T17:19:59Z",
    "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"
    }
  }
]

Create a comment

POST /shots/:shot/comments

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

Any username mentions, such as @simplebits, are automatically parsed and linked.

Parameters

Name Type Description
body string Required. The contents of the comment.

Example

{
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>"
}

Response

Status: 201 Created
Location: https://api.dribbble.com/v1/shots/471756/comments/3360155
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 1145736,
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
  "likes_count" : 1,
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
  "created_at" : "2012-03-15T04:24:39Z",
  "updated_at" : "2012-03-15T04:24:39Z",
  "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"
  }
}

Get a single comment

GET /shots/:shot/comments/:id

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 1145736,
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
  "likes_count" : 1,
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
  "created_at" : "2012-03-15T04:24:39Z",
  "updated_at" : "2012-03-15T04:24:39Z",
  "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"
  }
}

Update a comment

PUT /shots/:shot/comments/:id

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

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 1145736,
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
  "likes_count" : 1,
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
  "created_at" : "2012-03-15T04:24:39Z",
  "updated_at" : "2012-03-15T04:24:39Z",
  "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"
  }
}

Delete a comment

DELETE /shots/:shot/comments/:id

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

Response

Status: 204 No Content
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59

Check if you like a comment

GET /shots/:shot/comments/:id/like

Checking for a comment like requires the user to be authenticated.

Response, if the user likes the comment

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 24400091,
  "created_at" : "2014-01-06T17:19:59Z"
}

Response, if the user does not like the comment

Status: 404 Not Found
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59

Like a comment

POST /shots/:shot/comments/:id/like

Liking a comment requires the user to be authenticated with the write scope.

Response

Status: 201 Created
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 24400091,
  "created_at" : "2014-01-06T17:19:59Z"
}

Unlike a comment

DELETE /shots/:shot/comments/:id/like

Unliking a comment requires the user to be authenticated with the write scope.

Response

Status: 204 No Content
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59