# Dribbble Search API (dribbble.search)

- Canonical page: [https://everyinfra.com/en/dribbble-api/search](https://everyinfra.com/en/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 Search lists designers from Dribbble's designer directory and returns each one's name, username, profile link, avatar, location, `rating` with its `rating_scale`, review count, completed projects, starting price, average response time, number of services, skills and PRO status. It answers who can take on a given kind of design project, where they are based and how they are rated, for teams hiring freelancers, agencies scouting talent and analysts studying the market for design services.

Every parameter is optional, so an empty call browses the directory. Pick one specialty with `category`, such as `illustration` or `web-design`; `keyword` accepts the same specialty values and only counts when `category` is absent. `location` is free text about where a designer is based, such as London, not a service area or time zone. This capability searches designers, not their work: shots by keyword come from Dribbble Shots. Read `is_pro` as a membership, not a mark of quality.

## 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 | Filters designer `search` queries by a single professional category: `animation`, `branding`, `illustration`, `mobile`, `print`, `product-design`, `typography`, or `web-design`. Overrides category input passed in `keyword`; does not represent arbitrary work tags. |
| keyword | enum: animation / branding / illustration / mobile / print / product-design / typography / web-design | no | not declared | Serves as the design work search term in `shots` queries, or as the fallback designer category in `search` queries when `category` is omitted. Can be left empty when only browsing the designer directory. |
| location | not declared | no | not declared | Free-form text string filtering designers by location, such as "New York", "San Francisco, CA", or "London". Omitting this parameter disables location filtering. Does not represent service delivery areas or time zones. |
| min_budget | integer | no | not declared | Filters designers by minimum project budget in USD using integers from `0` to `10000`, where `0` sets no lower limit. Represents designer preferences rather than API execution costs or confirmed project quotes. |
| min_rating | enum: 1 / 2 / 3 / 4 / any | no | not declared | Filters designers by minimum rating threshold in designer searches. Allowed values are option strings: `any` (unrestricted), `1`, `2`, `3`, or `4` (representing the selected star rating and above). Expects exact option strings, not arbitrary decimal numbers like `4.5` or shot likes. |
| pro_only | not declared | no | not declared | Boolean flag filtering for Dribbble PRO designers when set to `true`, or leaving account type unrestricted when set to `false`. Must be passed as a JSON boolean, not a string (`"false"`). PRO status does not constitute a formal quality certification. |
| limit | integer (1–100) | no | 30 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | User's unique ID on the platform. |
| username | Username (@handle). |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| location | Location description passed through as is; the format varies by platform. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| projects_completed | platform-native meaning |
| starting_price | platform-native meaning |
| response_time | platform-native meaning |
| services_count | platform-native meaning |
| is_pro | platform-native meaning |
| skills | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example 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

### Can I search Dribbble designs by keyword here?

No. Dribbble Search lists designers, and its `keyword` only takes the specialty values that `category` takes, such as `branding` or `mobile`, applied when `category` is missing. To find design work by a free-text term, use the Dribbble Shots capability, whose keyword searches shots and which can sort them by popularity, recency or views.

### How do the rating, budget and PRO filters work?

`min_rating` takes `any` or a star level from 1 to 4, sent as a string, and keeps designers rated at that level or above; decimals such as 4.5 are not accepted. `min_budget` is a whole number of US dollars for the lowest project budget, with 0 meaning no floor; it is not a budget for API calls or a confirmed quote. `pro_only` must be a JSON boolean, not a string.

### How should I read `rating`?

Read `rating` next to `rating_scale`, which gives the maximum for that row, and `review_count`, which says how many reviews stand behind it. A high rating from a handful of reviews tells you little, and a null `review_count` means the number was not disclosed, not zero. `projects_completed` offers a second check on experience.

## 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
