Api

List Dribbble stories

List Dribbble stories with title, date, teaser and image.

GET/v1/dribbble/stories
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
categorystringquery

Story category slug (`category`), one of community, hang-time, inspiration, interviews, meetups, podcast, process, updates. An unknown slug is not_found.

max 100 chars · pattern: ^[a-z0-9-]+$

pageintegerquery

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

≥ 1 · ≤ 100

cursorstringquery

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
19

Endpoint-specific response payload.

datalookupStatus
string

`found` for a list that exists (including an empty last page); `not_found` when a requested category slug does not exist.

one of: found, not_found, restricted

Stories on this page, newest first.

datastories[]path
string

Story path after `/stories/`, e.g. `2026/10/31/slug`.

datastories[]url
string

Absolute URL of the story.

datastories[]title
string

Story title.

datastories[]publishedAt
stringnullable

Publication date (YYYY-MM-DD).

datastories[]excerpt
stringnullable

Teaser text.

datastories[]imageUrl
stringnullable

Teaser image URL.

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/stories?category=interviews&page=1" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Dribbble stories.