# Dribbble API

> Every Dribbble endpoint on Cotlet: inputs, JSON Schema, cURL, Python and Node.js examples and an example response for each call.

Source: https://cotlet.dev/docs/api/dribbble

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

11 endpoints for Dribbble. Each one is a POST with a JSON body, called with your API key.

- Base URL: `https://cotlet.dev/api/v1/dribbble`
- Connects with: Your own Dribbble account (a Pro account for Pro Analytics)
- Integration page: https://cotlet.dev/integrations/dribbble-api-mcp-server

## Endpoints

| Endpoint | Access | Description |
|---|---|---|
| `list_shots` | read | Your shots, newest first, with title, tags, publish date and URL. |
| `get_shot_stats` | read | Views, likes, saves and comment count of one of your shots. |
| `get_pro_analytics` | read | Pro Analytics: leads, proposals, funded projects, response time and rate, conversion and earnings. |
| `list_conversations` | read | Your Messages inbox: who, last message, time and whether it is unread. |
| `get_conversation` | read | All messages in a conversation, with sender, text, time and attached files. |
| `list_leads` | read | Project and Service Requests you received, with client, date, type and whether you replied. |
| `list_comments` | read | Comments on one of your shots, with author, text, time and whether you replied. |
| `upload_shot` | write | Publish a new shot from an image, with title, description and tags. |
| `update_shot` | write | Change the title, description or tags of one of your shots. |
| `reply_to_message` | write | Send a message as you in an existing conversation. |
| `reply_to_comment` | write | Reply as you under a comment on one of your shots. |

## List shots

`POST https://cotlet.dev/api/v1/dribbble/list_shots`

Access: read.

Returns your own shots, newest first, the same order as your profile. Each item has the title, tags, publish date and URL. Use the shot_id of an item in get_shot_stats, list_comments and update_shot. Pass next_cursor back as cursor for the next page.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | 1 to 100. Default: 24. |
| `cursor` | string | no | Next page cursor from the previous call. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/list_shots \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("dribbble", "list_shots")
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'list_shots');
```

**CLI**

```bash
cotlet call dribbble list_shots
```

### Example response

```json
{
  "shots": [
    {
      "shot_id": "21847531",
      "title": "Fintech dashboard",
      "tags": [
        "ui",
        "fintech",
        "dashboard"
      ],
      "published_at": "2026-10-08T09:30:00Z",
      "url": "https://dribbble.com/shots/21847531-Fintech-dashboard"
    },
    {
      "shot_id": "21790442",
      "title": "Onboarding flow",
      "tags": [
        "ux",
        "mobile"
      ],
      "published_at": "2026-09-30T14:10:00Z",
      "url": "https://dribbble.com/shots/21790442-Onboarding-flow"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjI0fQ"
}
```

## Get shot stats

`POST https://cotlet.dev/api/v1/dribbble/get_shot_stats`

Access: read.

Returns the engagement numbers Dribbble shows for one of your shots: views, likes, saves and the number of comments. It works for your own shots only. The numbers are the ones Dribbble shows at the time of the call.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `shot_id` | string | yes | Shot ID from list_shots. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/get_shot_stats \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shot_id":"shot_8c41d2"}'
```

**Python**

```python
result = client.call("dribbble", "get_shot_stats", {"shot_id":"shot_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'get_shot_stats', {"shot_id":"shot_8c41d2"});
```

**CLI**

```bash
cotlet call dribbble get_shot_stats --data '{"shot_id":"shot_8c41d2"}'
```

### Example response

```json
{
  "shot_id": "21847531",
  "title": "Fintech dashboard",
  "views": 4120,
  "likes": 186,
  "saves": 74,
  "comments": 12
}
```

## Get Pro Analytics

`POST https://cotlet.dev/api/v1/dribbble/get_pro_analytics`

Access: read.

Returns the figures of your Pro Analytics dashboard for a period: leads, project proposals, funded and completed projects, average project value, response time, response rate, lead conversion rate, cancellation rate and earnings. Dribbble refreshes these once a day. Needs a Pro account.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `period` | enum | no | 30d, 60d, 90d or all_time. Default: 30d. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/get_pro_analytics \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"60d"}'
```

**Python**

```python
result = client.call("dribbble", "get_pro_analytics", {"period":"60d"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'get_pro_analytics', {"period":"60d"});
```

**CLI**

```bash
cotlet call dribbble get_pro_analytics --data '{"period":"60d"}'
```

### Example response

```json
{
  "period": "30d",
  "leads": 14,
  "project_proposals": 6,
  "funded_projects": 3,
  "completed_projects": 2,
  "average_project_value": 2400,
  "response_time_hours": 3.5,
  "response_rate": 92.9,
  "lead_conversion_rate": 21.4,
  "cancellation_rate": 0,
  "earnings": 4800,
  "currency": "USD"
}
```

## List conversations

`POST https://cotlet.dev/api/v1/dribbble/list_conversations`

Access: read.

Lists your Dribbble Messages conversations, most recent first, with the other person, a preview of the last message, its time and whether it is unread. Set unread_only to see only what needs an answer. Pass conversation_id to get_conversation or reply_to_message.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `unread_only` | boolean | no | Only conversations with unread messages. |
| `limit` | integer | no | 1 to 50. Default: 20. |
| `cursor` | string | no | Next page cursor from the previous call. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/list_conversations \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("dribbble", "list_conversations")
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'list_conversations');
```

**CLI**

```bash
cotlet call dribbble list_conversations
```

### Example response

```json
{
  "conversations": [
    {
      "conversation_id": "8841207",
      "with": "Marta Kowal",
      "last_message": "Hi! We need a redesign of our analytics dashboard.",
      "updated_at": "2026-10-10T08:14:00Z",
      "unread": true
    }
  ],
  "next_cursor": null
}
```

## Get conversation

`POST https://cotlet.dev/api/v1/dribbble/get_conversation`

Access: read.

Returns the messages of one conversation, oldest first, with the sender, text, time and any attached files. Your agent reads the whole thread before it drafts a reply.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `conversation_id` | string | yes | Conversation ID from list_conversations. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/get_conversation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"conversation_8c41d2"}'
```

**Python**

```python
result = client.call("dribbble", "get_conversation", {"conversation_id":"conversation_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'get_conversation', {"conversation_id":"conversation_8c41d2"});
```

**CLI**

```bash
cotlet call dribbble get_conversation --data '{"conversation_id":"conversation_8c41d2"}'
```

### Example response

```json
{
  "conversation_id": "8841207",
  "with": "Marta Kowal",
  "messages": [
    {
      "from": "Marta Kowal",
      "body": "Hi! We need a redesign of our analytics dashboard.",
      "sent_at": "2026-10-10T08:14:00Z",
      "attachments": []
    }
  ]
}
```

## List leads

`POST https://cotlet.dev/api/v1/dribbble/list_leads`

Access: read.

Lists the Project and Service Requests you received, newest first, the same requests Pro Analytics counts as Leads. Each item has the client, the date, the request type and whether you have replied. Use unanswered_only to see what still needs an answer.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `since` | date | no | Only leads received on or after this date. |
| `unanswered_only` | boolean | no | Skip leads you already replied to. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/list_leads \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"since":"2026-10-05","unanswered_only":true}'
```

**Python**

```python
result = client.call("dribbble", "list_leads", {"since":"2026-10-05","unanswered_only":True})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'list_leads', {"since":"2026-10-05","unanswered_only":true});
```

**CLI**

```bash
cotlet call dribbble list_leads --data '{"since":"2026-10-05","unanswered_only":true}'
```

### Example response

```json
{
  "leads": [
    {
      "lead_id": "ld_30912",
      "client": "Marta Kowal",
      "type": "Project Request",
      "received_at": "2026-10-08T11:02:00Z",
      "replied": false,
      "conversation_id": "8841207"
    }
  ],
  "next_cursor": null
}
```

## List comments

`POST https://cotlet.dev/api/v1/dribbble/list_comments`

Access: read.

Lists the comments on one of your shots, newest first, with the author, text, time and whether you replied. Set unanswered_only to skip comments you already answered. Pass comment_id to reply_to_comment.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `shot_id` | string | yes | Shot ID from list_shots. |
| `unanswered_only` | boolean | no | Skip comments you already replied to. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/list_comments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shot_id":"shot_8c41d2"}'
```

**Python**

```python
result = client.call("dribbble", "list_comments", {"shot_id":"shot_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'list_comments', {"shot_id":"shot_8c41d2"});
```

**CLI**

```bash
cotlet call dribbble list_comments --data '{"shot_id":"shot_8c41d2"}'
```

### Example response

```json
{
  "shot_id": "21847531",
  "comments": [
    {
      "comment_id": "c_4471",
      "author": "Jonas Weber",
      "body": "Clean grid. What spacing scale is this?",
      "created_at": "2026-10-09T17:40:00Z",
      "replied": false
    }
  ],
  "next_cursor": null
}
```

## Upload shot

`POST https://cotlet.dev/api/v1/dribbble/upload_shot`

Access: write. Confirm: waits for the user's OK before it runs.

Publishes a new shot on your profile from an image URL, with a title, an optional description and tags. Set publish_at to schedule it. The shot appears under your name and is public once published. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `image_url` | string | yes | PNG, JPG or GIF by URL. |
| `title` | string | yes | Shot title. |
| `description` | string | no | Text shown under the shot. |
| `tags` | string[] | no | Tags that help the shot show up in search. |
| `publish_at` | datetime | no | Schedule it, ISO 8601 with time zone. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/upload_shot \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com","title":"title"}'
```

**Python**

```python
result = client.call("dribbble", "upload_shot", {"image_url":"https://example.com","title":"title"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'upload_shot', {"image_url":"https://example.com","title":"title"});
```

**CLI**

```bash
cotlet call dribbble upload_shot --data '{"image_url":"https://example.com","title":"title"}'
```

### Example response

```json
{
  "shot_id": "21901377",
  "status": "published",
  "title": "Fintech dashboard",
  "tags": [
    "ui",
    "fintech",
    "dashboard"
  ],
  "url": "https://dribbble.com/shots/21901377-Fintech-dashboard",
  "published_at": "2026-10-11T10:00:00+02:00"
}
```

## Update shot

`POST https://cotlet.dev/api/v1/dribbble/update_shot`

Access: write.

Changes the title, description or tags of one of your own shots. Fields you leave out stay as they are. It sends nothing to anyone and one more call restores the old text, so it runs without asking first.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `shot_id` | string | yes | Shot ID from list_shots. |
| `fields` | object | yes | Any of title, description, tags. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/update_shot \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shot_id":"shot_8c41d2","fields":"fields"}'
```

**Python**

```python
result = client.call("dribbble", "update_shot", {"shot_id":"shot_8c41d2","fields":"fields"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'update_shot', {"shot_id":"shot_8c41d2","fields":"fields"});
```

**CLI**

```bash
cotlet call dribbble update_shot --data '{"shot_id":"shot_8c41d2","fields":"fields"}'
```

### Example response

```json
{
  "shot_id": "21847531",
  "status": "updated",
  "title": "Fintech dashboard v2",
  "tags": [
    "ui",
    "fintech",
    "dashboard"
  ]
}
```

## Reply to message

`POST https://cotlet.dev/api/v1/dribbble/reply_to_message`

Access: write. Confirm: waits for the user's OK before it runs.

Sends a message in an existing conversation, under your name. The other person sees it in their Dribbble Messages. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `conversation_id` | string | yes | Conversation ID from list_conversations. |
| `body` | string | yes | Message text. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/reply_to_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"8841207","body":"Thanks for reaching out! I can start on the dashboard redesign next week. Could you share the current screens?"}'
```

**Python**

```python
result = client.call("dribbble", "reply_to_message", {"conversation_id":"8841207","body":"Thanks for reaching out! I can start on the dashboard redesign next week. Could you share the current screens?"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'reply_to_message', {"conversation_id":"8841207","body":"Thanks for reaching out! I can start on the dashboard redesign next week. Could you share the current screens?"});
```

**CLI**

```bash
cotlet call dribbble reply_to_message --data '{"conversation_id":"8841207","body":"Thanks for reaching out! I can start on the dashboard redesign next week. Could you share the current screens?"}'
```

### Example response

```json
{
  "message_id": "55120934",
  "conversation_id": "8841207",
  "status": "sent",
  "sent_at": "2026-10-10T14:22:05+02:00"
}
```

## Reply to comment

`POST https://cotlet.dev/api/v1/dribbble/reply_to_comment`

Access: write. Confirm: waits for the user's OK before it runs.

Posts a reply under one comment on your shot, under your name. The reply is public on the shot. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `comment_id` | string | yes | Comment ID from list_comments. |
| `body` | string | yes | Reply text. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/dribbble/reply_to_comment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"comment_8c41d2","body":"body"}'
```

**Python**

```python
result = client.call("dribbble", "reply_to_comment", {"comment_id":"comment_8c41d2","body":"body"})
```

**Node.js**

```js
const result = await cotlet.call('dribbble', 'reply_to_comment', {"comment_id":"comment_8c41d2","body":"body"});
```

**CLI**

```bash
cotlet call dribbble reply_to_comment --data '{"comment_id":"comment_8c41d2","body":"body"}'
```

### Example response

```json
{
  "comment_id": "c_4480",
  "reply_to": "c_4471",
  "status": "published"
}
```