Get a Dribbble profile

Try in Playground

Retrieve a designer or team profile with biography, headline, skills, languages, public contact links and visible counts.

GET/v1/dribbble/profilex-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

usernamestringrequiredquery

Dribbble username without @ or a URL, using 1 to 64 letters, digits, underscores or hyphens.

min 1 chars · max 64 chars

Exampleexample-designer

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

Published designer or team profile.

profile.idstring

Source designer ID as a decimal string.

profile.usernamestring

Canonical Dribbble username.

profile.urlstring

Canonical public profile URL.

absolute HTTPS URL

profile.namestring

Published profile name.

min 1 chars

profile.avatarUrlstringnullable

Public avatar URL, or null.

profile.bannerUrlstringnullable

Public masthead banner URL, or null.

profile.biostringnullable

Plain-text biography with HTML entities decoded, or null.

profile.headlinestringnullable

Published masthead introduction, or null.

profile.locationstringnullable

Published location, or null.

profile.memberSincestringnullable

Published membership date text, or null.

profile.isTeamboolean

Whether the source profile marks the account as a team.

profile.isProboolean

Whether the source profile displays the Pro badge.

profile.followersCountintegernullable

Visible follower count, or null.

≥ 0

profile.followingCountintegernullable

Visible following count, or null.

≥ 0

profile.shotsCountintegernullable

Visible shot count, or null.

≥ 0

profile.likesCountintegernullable

Visible received-like count, or null.

≥ 0

profile.tagsCountintegernullable

Visible tag count, or null.

≥ 0

profile.websitestringnullable

Published website URL, or null.

profile.emailstringnullable

Published contact email, or null.

Published website and social links in source order.

up to 100 items

profile.socialLinks.networkstring

Always included.

profile.socialLinks.urlstring

Always included.

absolute HTTPS URL

profile.skillsstring[]

Published skills in source order.

up to 100 items

profile.languagesstring[]

Published languages in source order.

up to 100 items

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/profile?username=example-designer" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/dribbble/profile?username=example-designer",
  {
    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/profile?username=example-designer",
  {
    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/profile",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "username": "example-designer"
    },
    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/profile?username=example-designer", 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/profile?username=example-designer"))
            .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": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://dribbble.com/example-designer/about",
  "fetchedAt": "2026-10-06T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 12000,
    "durationMs": 250
  },
  "profile": {
    "id": "1000",
    "username": "example-designer",
    "url": "https://dribbble.com/example-designer",
    "name": "Example Designer",
    "avatarUrl": "https://cdn.dribbble.com/users/1000/avatars/normal/synthetic.png",
    "bannerUrl": null,
    "headline": "Interfaces and illustrations.",
    "bio": "Synthetic designer biography.",
    "location": "Example City",
    "memberSince": "Member since Jan 2020",
    "isTeam": false,
    "isPro": false,
    "followersCount": 100,
    "followingCount": 20,
    "shotsCount": null,
    "likesCount": 40,
    "tagsCount": 10,
    "website": "https://example.com",
    "email": null,
    "socialLinks": [
      {
        "network": "website",
        "url": "https://example.com"
      }
    ],
    "skills": [
      "ui",
      "illustration"
    ],
    "languages": [
      "English"
    ]
  }
}

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."
  }
}