API Dribbble Поиск
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Просматривайте каталог дизайнеров Dribbble по специализации, местоположению, бюджету, рейтингу или статусу PRO. Получайте рейтинг, стартовую цену, время ответа и навыки каждого дизайнера. Результаты содержат сведения из профилей. Поиск не передаёт дизайнеру заказ и не подтверждает, что он свободен для работы.
Возможность Dribbble Search выводит дизайнеров из каталога дизайнеров Dribbble. Для каждого дизайнера она возвращает имя, имя пользователя, ссылку на профиль, аватар, местоположение, rating с rating_scale, число отзывов, число завершённых проектов, стартовую цену, среднее время ответа, число услуг, навыки и статус PRO. Она показывает, кто может взяться за определённый тип дизайн-проекта, где находятся эти дизайнеры и как их оценивают. Это нужно командам, которые нанимают фрилансеров, агентствам, которые ищут таланты, и аналитикам рынка дизайн-услуг.
Все параметры необязательны, поэтому вызов без параметров позволяет просматривать каталог. Выберите одну специализацию в category, например illustration или web-design. keyword принимает те же значения специализаций и учитывается, только если category не задан. В location укажите местоположение дизайнера произвольным текстом, например London; это не зона обслуживания и не часовой пояс. Эта возможность ищет дизайнеров, а не их работы: работы по ключевому слову ищите с помощью Dribbble Shots. is_pro означает членство в PRO, а не уровень качества.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Dribbble Поиск (dribbble/search).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: dribbble и action: search, а параметры передайте в params.
- Обязательных параметров нет.
- Необязательные параметры:
- category: Фильтрует запросы search по дизайнерам по одной профессиональной категории: animation, branding, illustration, mobile, print, product-design, typography или web-design. Переопределяет категорию, переданную в keyword. (допустимые значения: animation / branding / illustration / mobile / print / product-design / typography / web-design)
- keyword: Поисковый запрос по работам в shots либо категория дизайнеров в search, используемая, если параметр category не передан. Можно оставить пустым, если вы только просматриваете каталог дизайнеров. (допустимые значения: animation / branding / illustration / mobile / print / product-design / typography / web-design)
- location: Произвольная текстовая строка для фильтрации дизайнеров по местоположению, например «New York», «San Francisco, CA» или «London». Если параметр не передан, фильтр по местоположению не применяется.
- min_budget: Фильтрует дизайнеров по минимальному бюджету проекта в USD: целое число от 0 до 10000, где 0 означает отсутствие нижней границы.
- min_rating: Фильтрует дизайнеров по минимальному рейтингу при поиске дизайнеров. Допустимые значения передаются строками: any (без ограничений), 1, 2, 3 или 4 (выбранное число звёзд и выше). (допустимые значения: 1 / 2 / 3 / 4 / any)
- pro_only: Логический флаг: при true возвращаются только дизайнеры Dribbble PRO, при false тип аккаунта не ограничивается. Передавайте булево значение JSON, а не строку ("false").
- limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 30)
- Возвращает список записей. Основные поля каждой записи: user_id, username, name, url, avatar_url, location, rating, rating_scale, review_count, projects_completed, starting_price, response_time; всего полей: 15, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=dribbble.
- Пример тела запроса:
{
"platform": "dribbble",
"action": "search",
"params": {}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | dribbble | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | search | Идентификатор возможности, фиксированное значение. |
category | body.params | string (enum) | Нет | - | Фильтрует запросы search по дизайнерам по одной профессиональной категории: animation, branding, illustration, mobile, print, product-design, typography или web-design. Переопределяет категорию, переданную в keyword; это не произвольный тег работ.Допустимые значенияanimationbrandingillustrationmobileprintproduct-designtypographyweb-design |
keyword | body.params | string (enum) | Нет | - | Поисковый запрос по работам в shots либо категория дизайнеров в search, используемая, если параметр category не передан. Можно оставить пустым, если вы только просматриваете каталог дизайнеров.Допустимые значенияanimationbrandingillustrationmobileprintproduct-designtypographyweb-design |
location | body.params | string | Нет | - | Произвольная текстовая строка для фильтрации дизайнеров по местоположению, например «New York», «San Francisco, CA» или «London». Если параметр не передан, фильтр по местоположению не применяется. Это не зона оказания услуг и не часовой пояс. |
min_budget | body.params | integer | Нет | - | Фильтрует дизайнеров по минимальному бюджету проекта в USD: целое число от 0 до 10000, где 0 означает отсутствие нижней границы. Отражает предпочтения дизайнера, а не стоимость вызовов API или подтверждённую смету проекта. |
min_rating | body.params | string (enum) | Нет | - | Фильтрует дизайнеров по минимальному рейтингу при поиске дизайнеров. Допустимые значения передаются строками: any (без ограничений), 1, 2, 3 или 4 (выбранное число звёзд и выше). Ожидаются точные строковые значения, а не произвольные десятичные числа вроде 4.5 и не число лайков работ.Допустимые значения1234any |
pro_only | body.params | boolean | Нет | - | Логический флаг: при true возвращаются только дизайнеры Dribbble PRO, при false тип аккаунта не ограничивается. Передавайте булево значение JSON, а не строку ("false"). Статус PRO не является официальным подтверждением качества. |
limit | body.params | integer (1–100) | Нет | 30 | Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
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": {}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"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": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
user_id | Уникальный ID пользователя на платформе. |
username | Имя пользователя (@handle). |
name | Название самого объекта для возможностей по аккаунтам, товарам и компаниям. |
url | Ссылка на запись на платформе. |
avatar_url | Ссылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь. |
location | Описание местоположения передаётся как есть; формат зависит от платформы. |
rating | Рейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным. |
rating_scale | Максимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг. |
review_count | Количество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0. |
projects_completed | Трактуется так же, как на самой платформе |
starting_price | Трактуется так же, как на самой платформе |
response_time | Трактуется так же, как на самой платформе |
services_count | Трактуется так же, как на самой платформе |
is_pro | Трактуется так же, как на самой платформе |
skills | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
Можно ли здесь искать работы на Dribbble по ключевому слову?
Нет. Dribbble Search выводит дизайнеров, а параметр keyword принимает только те же значения специализаций, что и category, например branding или mobile, и применяется, когда category не задан. Чтобы найти дизайнерские работы по произвольному запросу, используйте возможность Dribbble Shots: её параметр keyword ищет шоты, а результаты можно сортировать по популярности, новизне или просмотрам.
Как работают фильтры по рейтингу, бюджету и PRO?
min_rating принимает any или уровень от 1 до 4 звёзд, переданный строкой, и оставляет дизайнеров с оценкой этого уровня и выше. Дробные значения, например 4.5, не принимаются. min_budget задаёт минимальный бюджет проекта целым числом долларов США, где 0 означает отсутствие нижней границы. Это не бюджет на вызовы API и не подтверждённая цена. pro_only должен быть булевым значением JSON, а не строкой.
Как понимать rating?
Смотрите на rating вместе с rating_scale, где указан максимум для этой записи, и с review_count, который показывает, сколько отзывов стоит за оценкой. Высокий рейтинг по нескольким отзывам мало о чём говорит. Значение null в review_count означает, что число не раскрыто, а не что оно равно нулю. projects_completed позволяет дополнительно оценить опыт.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.