Dribbble

Get Dribbble collection

Get Dribbble collection details and a page of its shots with likes and views.

GET/v1/dribbble/profiles/{handle}/collections/{collectionId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
handlestringrequiredpath

Dribbble profile handle, e.g. `simplebits`. Not case-sensitive.

pattern: ^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$

collectionIdstringrequiredpath

Collection id as it appears in Dribbble URLs, e.g. `4582-Data-Viz`. The numeric id alone is also accepted.

pattern: ^[0-9]{1,12}(?:-[A-Za-z0-9._~%-]{1,200})?$

pageintegeroptionalquery

Page number, 1 to 100; a numeric string is accepted too. Defaults to 1. Cannot be combined with `cursor`.

≥ 1 · ≤ 100

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same operation and filters.

min 1 chars · max 1024 chars

Response fields
41

Endpoint-specific response payload.

datalookupStatus
string

`found` on success. `not_found` when the profile, collection, service, job or story does not exist or was deleted. `restricted` when Dribbble requires a login to view it.

one of: found, not_found, restricted

The collection when `lookupStatus` is `found`; otherwise null.

datacollectionid
integer

Collection id.

≥ 0

datacollectionslug
stringnullable

Slug from the collection URL.

datacollectionpath
string

Path of the collection.

datacollectionurl
string

Absolute URL of the collection.

datacollectiontitle
string

Collection title.

The designer who curates the collection.

datacollectioncuratorhandle
stringnullable

Curator handle.

datacollectioncuratorname
stringnullable

Curator name.

datacollectionshotsCount
integernullable

Shots the collection holds.

datacollectiondesignersCount
integernullable

Designers in the collection.

Shots on this page.

datacollectionshots[]id
integer

Shot id.

≥ 0

datacollectionshots[]slug
stringnullable

Slug from the shot URL.

datacollectionshots[]path
string

Path of the shot.

datacollectionshots[]url
string

Absolute URL of the shot.

datacollectionshots[]title
string

Shot title.

The designer who posted the shot.

datacollectionshots[]authorhandle
stringnullable

Profile handle of the author.

datacollectionshots[]authorname
stringnullable

Display name of the author.

datacollectionshots[]authoruserId
integernullable

Dribbble user id of the author, when available.

datacollectionshots[]authorisPro
boolean

Whether the author carries the Pro badge.

datacollectionshots[]likesCount
integernullable

Exact like count.

datacollectionshots[]viewsText
stringnullable

Views exactly as displayed, e.g. `17.7k`.

datacollectionshots[]viewsEstimate
integernullable

Views parsed from `viewsText`.

datacollectionshots[]viewsApproximate
boolean

True when the displayed views were a rounded `k`/`m` value.

datacollectionshots[]reboundsCount
integernullable

Rebound count, when available.

datacollectionshots[]thumbnailUrl
stringnullable

Thumbnail URL.

datacollectionshots[]isMotion
boolean

Whether the shot is motion.

Pagination state for the current page.

datapagepage
integer

Current page number (1-based).

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number when more pages exist; null on the last page.

≥ 0

datapagenextCursor
stringnullable

Cursor for the next page, for the same filters; null on the last page.

datapagetotalPages
integernullable

Known last page, when it is known in advance (from a collection's shot count, or Dribbble's own cap); null otherwise.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/dribbble/profiles/simplebits/collections/4582-Data-Viz" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Dribbble collection.