EveryData platform API
Dribbble API
Dribbble provides three action-specific views for shot discovery, creator shot lists, and designer profiles: `search`, `shots`, and `profile`.
Dribbble keeps `search` (matching public results) apart from `shots` (designer shot records); no required business input, and `keyword` apply only inside those contracts.
- Endpoint
- POST /api/v1/social
- Capabilities
- 3
- Per 1,000
- $1.389
Available capabilities
Compare the Dribbble actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Use Dribbble | category, keyword, location, min_budget, min_rating, pro_only | Sync delivery | Catalog values: defaultLimit=30, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | 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 | |
shotsShots The object handled by Dribbble | keyword | query, sort | Sync delivery | Catalog values: defaultLimit=24, maxLimit=60. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | shot_id · title · url · author_name · author_url · view_count · like_count · comment_count · tags · image_url · is_pro · is_animated · platform |
profileProfiles Use Dribbble | username | sort | Sync delivery | — | $1.39 per 1,000 requests | user_id · username · name · bio · url · avatar_url · location · follower_count · rating · rating_scale · platform |
What does each Dribbble action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Dribbble search parameters mean?
Use Dribbble search to discover Dribbble public results. In this contract, invoke it without a required business field, using optional category, keyword, location solely when the contract lists it. For Dribbble search, supply min_rating, keyword, location, pro_only, category, and min_budget; results include review_count, rating, rating_scale, username, avatar_url, url, services_count, response_time, skills, platform, name, is_pro, starting_price, projects_completed, user_id, and location.
categoryOptional- Filters designer
searchqueries by a single professional category:animation,branding,illustration,mobile,print,product-design,typography, orweb-design. Overrides category input passed inkeyword; does not represent arbitrary work tags. keywordOptional- Serves as the design work search term in
shotsqueries, or as the fallback designer category insearchqueries whencategoryis omitted. Can be left empty when only browsing the designer directory. locationOptional- 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_budgetOptional- Filters designers by minimum project budget in USD using integers from
0to10000, where0sets no lower limit. Represents designer preferences rather than API execution costs or confirmed project quotes. min_ratingOptional- Filters designers by minimum rating threshold in designer searches. Allowed values are option strings:
any(unrestricted),1,2,3, or4(representing the selected star rating and above). Expects exact option strings, not arbitrary decimal numbers like4.5or shot likes.Allowed values:1234any pro_onlyOptional- Boolean flag filtering for Dribbble PRO designers when set to
true, or leaving account type unrestricted when set tofalse. Must be passed as a JSON boolean, not a string ("false"). PRO status does not constitute a formal quality certification.
What do the Dribbble shots parameters mean?
The object handled by Dribbble shots is designer shot records. Use Dribbble shots with keyword for Dribbble designer shot records. Call Dribbble shots with keyword, sort, and query; Dribbble shots exposes shot_id, like_count, platform, is_animated, author_url, comment_count, tags, title, url, is_pro, image_url, view_count, and author_name.
keywordRequired- Serves as the design work search term in
shotsqueries, or as the fallback designer category insearchqueries whencategoryis omitted. Can be left empty when only browsing the designer directory.Dribbble: Showcasing Design Work and Process in ShotsDribbble documentation notes that Shots use images, text, and videos to showcase design results and processes, with tags describing work content. Fetching display metadata for a Shot does not equate to acquiring the full design source files.Checked queryOptional- Compatibility alias for design work search terms in
shotsactions. Thekeywordparameter takes precedence and remains required; this field is not used for category selection in designer directory searches. sortOptional- Sorts design work lists in
shotsactions; allowed values arepopular,newest, andmost_viewed. When passed toprofileactions, this parameter has no verified sorting effect on user objects and should not be relied upon.Allowed values:most_viewednewestpopular
What do the Dribbble profile parameters mean?
Use Dribbble profile to read one Dribbble public record. Use Dribbble account input with profile; Dribbble then reads public record. Call Dribbble profile with sort and username; Dribbble profile exposes platform, name, url, avatar_url, username, bio, rating, follower_count, location, rating_scale, and user_id.
usernameRequired- Dribbble designer profile handle extracted from the profile URL path, passed without an
@prefix or full URL structure. Used byprofilequeries to fetch user account details, not individual shot IDs.Dribbble: Distinction Between Designer Profile and Individual ShotsDribbble distinguishes work showcases from a designer's Profile containing bio, location, skills, and work preferences. Referencing these entity definitions does not mean this endpoint supports initiating projects or hiring designers.Checked sortOptional- Sorts design work lists in
shotsactions; allowed values arepopular,newest, andmost_viewed. When passed toprofileactions, this parameter has no verified sorting effect on user objects and should not be relied upon.Allowed values:most_viewednewest
How to use the Dribbble API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"dribbble","action":"search","params":{}}'
Dribbble API questions
What can I retrieve with the Dribbble API?
Set platform to dribbble. The current catalog lists search, shots, and profiles. These action names identify different Dribbble objects or views; they are not interchangeable search modes.
Which input starts a Dribbble `search` request?
The search action has no required business input. Send the platform and action identifiers, plus only the optional parameters you need.
Which fields can Dribbble `search` return?
Its declared schema includes user_id, username, name, and avatar_url. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Dribbble action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.