# Dribbble 关键词搜索 API (dribbble.search)

- Canonical page: [https://everyinfra.com/dribbble-api/search](https://everyinfra.com/dribbble-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "dribbble", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 30, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

Dribbble 关键词搜索查的是 Dribbble 的设计师目录，而不是作品：每行是一位设计师，带名称、用户名、主页链接、所在地、评分、评价数、已完成项目数、服务起步价、平均回复时长、服务数量、技能标签和是否 PRO 会员。它回答「哪些设计师能接这类项目、人在哪里、口碑如何」，适合找外包设计的团队、物色人才的设计机构，以及研究设计服务市场的分析师。

所有参数都可以不传，空调用就是浏览目录。用 `category` 选一个专业方向，比如 `illustration`；`location` 是设计师所在地的自由文本，例如 London，不是服务地区或时区。`is_pro` 只说明会员身份，不代表作品质量。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=dribbble&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| category | enum: animation / branding / illustration / mobile / print / product-design / typography / web-design | no | not declared | search 的单个设计师专业类别：animation 动画、branding 品牌标识、illustration 插画、mobile 移动端、print 印刷、product-design 产品设计、typography 字体排版、web-design 网页设计。它覆盖 keyword 的类别输入；不是任意作品标签。 |
| keyword | enum: animation / branding / illustration / mobile / print / product-design / typography / web-design | no | not declared | shots 中为设计作品搜索词；search 中作为 category 未提供时的设计师专业类别输入，不是同一类搜索。仅浏览设计师目录时可以不填 keyword。 |
| location | not declared | no | not declared | 设计师所在地的自由文本，例如 New York、San Francisco, CA、London；省略则不按地区筛选。它不是服务交付地区或时区。 |
| min_budget | integer | no | not declared | 设计师项目预算下限，以 USD 表示，整数 0–10000；0 为不设下限。不是 API 调用预算或已确认的项目报价。 |
| min_rating | enum: 1 / 2 / 3 / 4 / any | no | not declared | 设计师最低星级门槛：any 不限，1 / 2 / 3 / 4 表示该星级及以上。这里传选项字符串，不是 4.5 这样的任意小数，也不是作品点赞数。 |
| pro_only | not declared | no | not declared | 布尔值 true 表示仅筛选 Dribbble PRO 设计师，false 不限定。必须用 JSON 布尔值，不要传字符串 false；PRO 不等于作品质量认证。 |
| limit | integer (1–100) | no | 30 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | 用户在原平台的唯一 ID。 |
| username | 用户名（@handle）。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| url | 该记录在原平台上的可访问链接。 |
| avatar_url | 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。 |
| location | 地理位置描述，原文透传，格式随平台而异。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| review_count | 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。 |
| projects_completed | 已完成项目数。 |
| starting_price | 服务起步价。 |
| response_time | 平均回复时长。 |
| services_count | 提供的服务数量。 |
| is_pro | 是否为 Dribbble Pro 会员。 |
| skills | 技能标签。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "dribbble",
  "action": "search",
  "params": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "dribbble",
        "action": "search",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 27. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "dribbble",
  "action": "search",
  "results": [
    {
      "user_id": "•••",
      "username": "•••",
      "name": "HALO LAB",
      "url": "https://dribbble.com/halolab",
      "avatar_url": "https://cdn.dribbble.com/•••",
      "location": "Warsaw, Poland",
      "rating": 4.9,
      "review_count": 141,
      "projects_completed": 144,
      "starting_price": "From $5,000/project",
      "response_time": "Responds in about 1 hour",
      "services_count": 15,
      "is_pro": true,
      "skills": [],
      "platform": "dribbble",
      "rating_scale": 5
    },
    {
      "user_id": "•••",
      "username": "•••",
      "name": "Phenomenon Studio",
      "url": "https://dribbble.com/phenomenonstudio",
      "avatar_url": "https://cdn.dribbble.com/•••",
      "location": "United States",
      "rating": 5,
      "review_count": 81,
      "projects_completed": 89,
      "starting_price": "From $5,000/project",
      "response_time": "Responds in about 3 hours",
      "services_count": 10,
      "is_pro": true,
      "skills": [],
      "platform": "dribbble",
      "rating_scale": 5
    }
  ],
  "count": 27,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 能在这里按关键词搜设计作品吗？

不能。这个能力列的是设计师，`keyword` 只接受和 `category` 相同的专业取值，比如 `branding`、`mobile`，而且只在没传 `category` 时生效。按任意词找作品请用 Dribbble 设计作品，它的检索词搜的是作品，还能按热门、最新或浏览量排序。

### 评分、预算和 PRO 筛选怎么传？

`min_rating` 取 `any` 或 `1` 到 `4`，按字符串传，保留该星级及以上的设计师，不接受 4.5 这样的小数。`min_budget` 是以美元计的项目预算下限，传整数，0 表示不设下限，和 API 调用费用无关。`pro_only` 必须是 JSON 布尔值，不能传字符串。

### `rating` 应该怎么看？

和同一行的 `rating_scale`（满分）、`review_count`（评价数）一起看：只有几条评价撑着的高分说明不了太多，`review_count` 为 null 表示没有公开，不等于 0。`projects_completed` 是已完成的项目数，可以作为经验的第二个参照。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=dribbble
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
