Dribbble検索API
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好/正常
- 利用可能
- 制限あり
- ほぼ停止
過去24時間
過去30日間
Dribbbleのデザイナーディレクトリを、専門分野、所在地、予算、評価、PROステータスで絞り込んで閲覧できます。各デザイナーの評価、最低料金、返信時間、スキルを取得できます。結果はプロフィールの情報であり、仕事を発注するものでも、デザイナーが依頼を受けられることを確認するものでもありません。
Dribbble Searchは、Dribbbleのデザイナーディレクトリからデザイナーを一覧表示し、各デザイナーの名前、ユーザー名、プロフィールリンク、アバター、所在地、ratingとそのrating_scale、レビュー数、完了したプロジェクト数、最低料金、平均返信時間、サービス数、スキル、PROステータスを返します。特定の種類のデザインプロジェクトを誰が引き受けられるか、どこを拠点とし、どう評価されているかがわかるため、フリーランサーを採用するチーム、人材を探すエージェンシー、デザインサービス市場を調査するアナリストに役立ちます。
パラメータはすべて任意なので、何も指定せずに呼び出すとディレクトリを閲覧できます。categoryでillustrationやweb-designなどの専門分野を1つ選びます。keywordも同じ専門分野の値を受け付けますが、categoryがない場合にのみ適用されます。locationはLondonのようにデザイナーの拠点を表す自由記述で、サービス提供地域やタイムゾーンではありません。この機能は作品ではなくデザイナーを検索します。キーワードでショットを探すにはDribbble Shotsを使用してください。is_proは品質の証ではなく、メンバーシップを示すものとして扱ってください。
料金は1,000リクエストあたり$1.39(1回あたり$0.001389)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
EveryInfraのDribbble 検索エンドポイント(dribbble/search)を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数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は下限なしを意味します。デザイナーの希望条件を表すもので、API実行コストや確定したプロジェクトの見積もりではありません。
- min_rating: デザイナー検索で、デザイナーを最低評価のしきい値で絞り込みます。指定できる値はオプション文字列のany(制限なし)、1、2、3、4(選択した星の数以上を表します)です。オプション文字列と完全に一致する値を指定してください。4.5のような任意の小数や、ショットのいいね数は指定できません。(指定可能な値:1 / 2 / 3 / 4 / any)
- pro_only: trueにするとDribbble PROのデザイナーに絞り込み、falseにするとアカウント種別を制限しないブール値のフラグです。文字列("false")ではなく、JSONのブール値で渡す必要があります。PROステータスは正式な品質認定ではありません。
- limit: この呼び出しで返す最大行数で、1〜100の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。(デフォルト: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,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。
コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。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にするとアカウント種別を制限しないブール値のフラグです。文字列("false")ではなく、JSONのブール値で渡す必要があります。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からAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
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 | ユーザー名(@ハンドル)です。 |
name | 対象そのものの名前です(アカウント・商品・ビジネス系の機能で使用)。 |
url | プラットフォーム上のレコードへのリンクです。 |
avatar_url | アバター画像のリンクです。一部のプラットフォームでは、サイズ指定付きで有効期限が切れる可能性のあるCDNリンクが返されます。 |
location | 位置情報の説明で、そのまま渡されます。形式はプラットフォームによって異なります。 |
rating | 評価です。スケールはプラットフォームによって異なります。最大値は同じ行のrating_scaleで示されます(通常は5。Booking、Douban、iQIYI、NAVERは10)。プラットフォーム間で比較する前にrating_scaleで換算してください。換算しないと比較結果が逆転することがあります。 |
rating_scale | 同じ行のratingの最大値です。5段階評価では5、10点満点では10になります。行にratingがある場合のみ含まれます。 |
review_count | レビュー数です(商品・ビジネス系の機能で使用)。nullは非公開を示し、0ではありません。 |
projects_completed | プラットフォーム上の意味のまま |
starting_price | プラットフォーム上の意味のまま |
response_time | プラットフォーム上の意味のまま |
services_count | プラットフォーム上の意味のまま |
is_pro | プラットフォーム上の意味のまま |
skills | プラットフォーム上の意味のまま |
platform | 取得元プラットフォームの識別子で、リクエストのplatformと同じです(例:xiaohongshu、tiktok)。 |
FAQ
ここでDribbbleのデザインをキーワードで検索できますか?
いいえ。Dribbble Searchはデザイナーを一覧表示する機能です。そのkeywordはbrandingやmobileなどcategoryと同じ専門分野の値のみを受け付け、categoryがない場合に適用されます。自由記述の語句でデザイン作品を探すには、Dribbble Shots機能を使用してください。Dribbble Shotsはキーワードでショットを検索でき、人気順、新着順、閲覧数順に並べ替えられます。
評価、予算、PROのフィルターはどのように機能しますか?
min_ratingはanyまたは1〜4の星の数を文字列で受け付け、その評価以上のデザイナーに絞り込みます。4.5のような小数は使えません。min_budgetはプロジェクト予算の下限を表す米ドルの整数で、0は下限なしを意味します。API呼び出しの予算や確定した見積もりではありません。pro_onlyは文字列ではなく、JSONのブール値で指定する必要があります。
ratingはどう読めばよいですか?
ratingは、その行の最大値を示すrating_scaleと、評価の根拠となるレビュー数を示すreview_countとあわせて読んでください。少数のレビューによる高評価はあまり参考になりません。また、review_countがnullの場合はゼロではなく非公開を意味します。経験を確かめる別の指標としてprojects_completedも使えます。
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200(空)
- データがありません。課金はされません。