社交内容 · 数据 API

Dribbble

Dribbble API

分别检索 Dribbble 设计师与 Shot 作品,读取设计师资料、服务线索和作品链接;人物筛选不是作品搜索,也不提供设计源文件或使用授权。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

3

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Dribbble 能力清单

action必填参数可选参数单次条数模式单价返回字段
search—category, keyword, location, min_budget, min_rating, pro_only默认 30 · 最多 100同步$1.39 / 千次user_id · username · name · url · avatar_url · location · rating · rating_scale · review_count · projects_completed · starting_price · response_time · services_count · is_pro · skills · platform
shotskeywordquery, sort默认 24 · 最多 60同步$1.39 / 千次shot_id · title · url · author_name · author_url · view_count · like_count · comment_count · tags · image_url · is_pro · is_animated · platform
profileusername——同步$1.39 / 千次user_id · username · name · bio · url · avatar_url · location · follower_count · rating · rating_scale · platform

Dribbble 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Dribbble 设计作品 API?

shots

使用 platform="dribbble"、action="shots" 调用“设计作品”能力;返回列表,默认 24 条、单次最多 60 条,主要包含 shot_id、title、url、author_name、author_url、view_count 等 13 个字段。

Dribbble shots 的参数分别是什么意思?

keyword必填
shots 中为设计作品搜索词;search 中作为 category 未提供时的设计师专业类别输入,不是同一类搜索。仅浏览设计师目录时可以不填 keyword。

Dribbble 说明 Shot 可用图片、文字和视频展示设计成果与过程,标签描述作品内容;读取 Shot 的展示元数据不等于取得完整设计源文件。官方来源:Dribbble:Shot 展示的作品与过程来源核查:

query可选
shots 的作品检索词兼容输入;keyword 优先且仍为公开必填,不用于设计师目录的类别选择。
sort可选
sort 仅用于 shots 作品列表:popular 热门、newest 最近发布、most_viewed 浏览最多。profile 不公开该参数。
查看全部 3 个允许值

most_viewednewestpopular

Dribbble 特有返回字段与含义(3)
is_pro
是否为 Dribbble Pro 会员。
shot_id
作品(shot)ID。
is_animated
作品是否为动态图。

怎么调用 Dribbble 主页或对象详情 API?

profile

使用 platform="dribbble"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 user_id、username、name、bio、url、avatar_url 等 11 个字段。

Dribbble profile 的参数分别是什么意思?

username必填
Dribbble 设计师主页路径中的用户名,不带 @ 或完整链接;profile 查询该用户名资料,不是 shot ID。

Dribbble 将作品展示与包含简介、所在地、技能和工作偏好的个人 Profile 区分;这里引用对象含义,不表示本接口具备发起项目或雇用设计师的能力。官方来源:Dribbble:设计师 Profile 与作品的区别来源核查:

Dribbble search 调用流程一次 Dribbble search 调用的全过程:向 POST /api/v1/social 发送 platform="dribbble"、action="search";返回结构化 JSON,含 user_id、username、name、url、avatar_url 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "dribbble"action: "search"无必填参数EveryInfra$1.39 / 千次2 · 响应 · 列表user_idusernamenameurlavatar_url
一次 Dribbble search 调用的全过程:向 POST /api/v1/social 发送 platform="dribbble"、action="search";返回结构化 JSON,含 user_id、username、name、url、avatar_url 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。

Dribbble 原始字段名

EveryInfra 统一字段名

左边是 Dribbble 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Dribbble 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 6 个字段名只在 Dribbble 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • projects_completed
  • starting_price
  • response_time
  • services_count
  • shot_id
  • is_animated

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

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)。
shot_id
作品(shot)ID。
title
标题。平台无标题概念时(如纯文本帖)为 null。
author_name
作者昵称(显示名)。
author_url
作者在原平台的主页链接。
view_count
浏览/播放数。null 表示不公开,不等于 0。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count
评论数。null 表示不公开,不等于 0。
tags
标签数组。无标签时为空数组,不是 null。
image_url
图片链接。多图能力可能返回 image_urls 数组。
is_animated
作品是否为动态图。
bio
个人简介,账号自己填写的文本。可能含换行和 emoji。
follower_count
粉丝数。null 表示不公开,不等于 0。

请求填写示例

search 可不填必填参数,浏览设计师目录;作品关键词检索是 shots,不要混用。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

dribbble_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"dribbble","action":"search","params":{}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "user_id": null,
  "username": null,
  "name": null,
  "url": null,
  "avatar_url": null,
  "location": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "projects_completed": null,
  "starting_price": null,
  "response_time": null,
  "services_count": null,
  "is_pro": null,
  "skills": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

按专业类别初筛 Dribbble 设计师

用 search 看服务提供者,再核对所在地、起步预算和公开服务记录。

查看 search 的 category 参数 →
  • category 使用 branding、web-design 等已说明的专业类别,覆盖 keyword 的类别输入;location 是设计师所在地,starting_price、projects_completed、services_count 与 skills 是人物服务信息。
  • 这不是 shots 作品搜索;min_budget 不等于已确认报价,min_rating / min_budget / pro_only 并非所有执行路径都统一应用,不能把筛选结果当作已验证满足全部条件。

按 Dribbble Shot 主题整理设计参考

用 shots 找具体设计展示,保留作品和设计师的不同链接。

查看 shots 的 sort 参数 →
  • keyword 填作品主题,sort=newest 按最近发布;shot_id、title、url 标识作品,author_url 指向作者,image_url 是展示图片。
  • view_count / like_count 可能保留 26.1k 这样的缩写字符串,不能直接作整数相加;当前没有单个 shot 详情接口,也不提供设计源文件或素材使用授权。

区分 Dribbble 设计师资料与 Shot

用 profile 查看用户名对应的个人资料,不用作品 ID 代替用户标识。

查看 profile 的 username 参数 →
  • username 填设计师主页路径短名,不带 @ 或完整 URL;name、bio、location、follower_count 与 url 用于核对公开账号信息。
  • profile 的 sort 虽在目录中,但没有已验证的单用户排序效果;follower_count 是数量而非粉丝名单,资料也不是完整作品内容。

Dribbble API 常见问题

Dribbble API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="dribbble"、action 和 params。以 search 为例,必填 无参数,可选 category、keyword、location、min_budget。search 可不填必填参数,浏览设计师目录;作品关键词检索是 shots,不要混用。 Dribbble 共 3 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Dribbble API 怎么收费?

$1.39 / 千次,Dribbble 全部 3 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Dribbble 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Dribbble API 一次能返回多少条数据?

Dribbble 有 2 个列表接口,包括 search、shots。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Dribbble API 返回哪些字段?

当前目录为 search 列出 user_id、username、name、url、avatar_url、location 等 16 个字段名。按全站当前目录统计,6 个字段名只在 Dribbble 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「按专业类别初筛 Dribbble 设计师」怎样接入 Dribbble API?

用 search 看服务提供者,再核对所在地、起步预算和公开服务记录。 category 使用 branding、web-design 等已说明的专业类别,覆盖 keyword 的类别输入;location 是设计师所在地,starting_price、projects_completed、services_count 与 skills 是人物服务信息。 这不是 shots 作品搜索;min_budget 不等于已确认报价,min_rating / min_budget / pro_only 并非所有执行路径都统一应用,不能把筛选结果当作已验证满足全部条件。

「按 Dribbble Shot 主题整理设计参考」怎样接入 Dribbble API?

用 shots 找具体设计展示,保留作品和设计师的不同链接。 keyword 填作品主题,sort=newest 按最近发布;shot_id、title、url 标识作品,author_url 指向作者,image_url 是展示图片。 view_count / like_count 可能保留 26.1k 这样的缩写字符串,不能直接作整数相加;当前没有单个 shot 详情接口,也不提供设计源文件或素材使用授权。

「区分 Dribbble 设计师资料与 Shot」怎样接入 Dribbble API?

用 profile 查看用户名对应的个人资料,不用作品 ID 代替用户标识。 username 填设计师主页路径短名,不带 @ 或完整 URL;name、bio、location、follower_count 与 url 用于核对公开账号信息。 profile 的 sort 虽在目录中,但没有已验证的单用户排序效果;follower_count 是数量而非粉丝名单,资料也不是完整作品内容。

可以先免费试用 Dribbble API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Dribbble 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 3 个能力。无需信用卡。

开始调用 Dribbble API

加微信领 $1 免费额度,先选一个 Dribbble 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始