Get a Dribbble collection

Try in Playground

Retrieve a public collection's name, description, owner, counts and one source page of shots with preview media.

GET/v1/dribbble/collectionx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Dribbble collection URL in the form https://dribbble.com/<username>/collections/<id>-<slug>. Tracking query parameters and fragments are removed.

max 2048 chars

Examplehttps://dribbble.com/example-designer/collections/1001-Interface-patterns

pagestringquery

Source page number from 1 to 100; defaults to 1. Pass nextPage from the response to continue.

Response fields

successboolean

True when usable data is returned; inspect status and coverage.

statusenum

success or partial for usable data; failed or challenged for a failure.

one of: success, partial

requestIdstring

Request correlation UUID.

sourceUrlstring

Canonical Dribbble source page URL.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Returned-page coverage and extraction warnings.

coverage.sourcestring

Public Dribbble page.

coverage.completeboolean

Whether all supported fields in this source page were extracted without reported omissions.

coverage.warningsenum[]

Named extraction, record-limit and pagination warnings.

Retrieval attempt, source byte and timing measurements.

accounting.upstreamRequestsinteger

Number of upstream request attempts, including redirects and retry.

≥ 0

accounting.responseBytesinteger

Decoded source bytes read during this request.

≥ 0

accounting.durationMsnumber

Elapsed operation time in milliseconds.

≥ 0

Public collection details.

collection.idstring

Source collection ID as a decimal string.

collection.urlstring

Canonical public collection URL.

absolute HTTPS URL

collection.namestring

Published collection name.

min 1 chars

collection.descriptionstringnullable

Published plain-text collection description, or null.

Displayed collection owner, or null.

collection.owner.usernamestring

Owner username.

collection.owner.namestringnullable

Published owner name, or null.

collection.owner.urlstring

Owner profile URL.

absolute HTTPS URL

collection.owner.avatarUrlstringnullable

Owner avatar URL, or null.

collection.shotsCountintegernullable

Published total collection shot count, or null.

≥ 0

collection.designersCountintegernullable

Published total collection designer count, or null.

≥ 0

Collection shots in source order.

up to 100 items

shots.idstring

Always included.

shots.urlstring

Always included.

absolute HTTPS URL

shots.titlestring

Always included.

min 1 chars

shots.thumbnailUrlstringnullable

Always included.

shots.videoUrlstringnullable

Always included.

shots.author.usernamestring

Always included.

shots.author.namestringnullable

Always included.

shots.author.urlstring

Always included.

absolute HTTPS URL

shots.author.avatarUrlstringnullable

Always included.

shots.likesCountintegernullable

Always included.

≥ 0

shots.viewsCountintegernullable

Always included.

≥ 0

Source-linked page navigation.

pagination.pageinteger

Current requested source page number.

1 – 100

pagination.nextPageintegernullable

Next page number explicitly linked by this source page, or null.

1 – 100

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with named metadata, metric, source-page, pagination, record-limit or invalid-item warnings.
400	`invalid_request`	Missing, duplicate, malformed, unsafe or unsupported parameters.
401	`unauthorized`	Missing or invalid worker API key.
404	`not_found`	The requested public profile or collection was not found.
422	`restricted_page`	The source requires authorization for the requested resource.
422	`unsupported_page`	The source layout or identity could not be mapped.
502	`upstream_challenged`	The source challenged retrieval.
502	`upstream_rate_limited`	The source rate-limited retrieval.
502	`upstream_error`	Source retrieval did not complete.
502	`response_too_large`	Decoded source bytes exceeded the request limit.
502	`unsafe_redirect`	The source redirected outside the permitted route.
502	`request_limit`	The source request budget was exhausted.
503	`busy`	Worker request or queue capacity was exceeded.
504	`timeout`	The operation deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/dribbble/collection?url=https%3A%2F%2Fdribbble.com%2Fexample-designer%2Fcollections%2F1001-Interface-patterns" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/dribbble/collection?url=https%3A%2F%2Fdribbble.com%2Fexample-designer%2Fcollections%2F1001-Interface-patterns",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/dribbble/collection?url=https%3A%2F%2Fdribbble.com%2Fexample-designer%2Fcollections%2F1001-Interface-patterns",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Dribbble request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/dribbble/collection",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://dribbble.com/example-designer/collections/1001-Interface-patterns"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/dribbble/collection?url=https%3A%2F%2Fdribbble.com%2Fexample-designer%2Fcollections%2F1001-Interface-patterns", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/dribbble/collection?url=https%3A%2F%2Fdribbble.com%2Fexample-designer%2Fcollections%2F1001-Interface-patterns"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "partial",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://dribbble.com/example-designer/collections/1001-Interface-patterns",
  "fetchedAt": "2026-10-06T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": false,
    "warnings": [
      "source_page_only",
      "metrics_unavailable"
    ]
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 12000,
    "durationMs": 250
  },
  "collection": {
    "id": "1001",
    "url": "https://dribbble.com/example-designer/collections/1001-Interface-patterns",
    "name": "Interface patterns",
    "description": "Synthetic interface collection.",
    "owner": {
      "username": "example-designer",
      "name": "Example Designer",
      "url": "https://dribbble.com/example-designer",
      "avatarUrl": null
    },
    "shotsCount": 12,
    "designersCount": 3
  },
  "shots": [
    {
      "id": "2001",
      "url": "https://dribbble.com/shots/2001-Example-interface",
      "title": "Example interface",
      "thumbnailUrl": "https://cdn.dribbble.com/userupload/2001/file/synthetic.png",
      "videoUrl": null,
      "author": {
        "username": "example-designer",
        "name": "Example Designer",
        "url": "https://dribbble.com/example-designer",
        "avatarUrl": null
      },
      "likesCount": null,
      "viewsCount": null
    }
  ],
  "pagination": {
    "page": 1,
    "nextPage": null
  }
}

Missing, duplicate, malformed, unsafe or unsupported parameters.

{
  "success": false,
  "status": "failed",
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}