---
title: "Bluesky User Profile"
method: GET
path: "/v1/bluesky/user"
tags: ["Bluesky"]
---

# Bluesky User Profile

`GET /v1/bluesky/user`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/bluesky/user`
- Auth: API key in header `X-API-Key`

Get a Bluesky user's full profile by handle, DID, or profile URL. Returns display name, bio, follower/following/post counts, verification status, profile picture and banner, join date, and the pinned post's ID.

**Price:** $0.003 per request. **Free tier:** 50 requests/month.

## Query parameters

- `username` string
- `url` string

## Response `200`

Successful response

- BlueskyUserProfileResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `user` object, nullable
    - `username` string, nullable
    - `full_name` string, nullable
    - `user_id` string, nullable
    - `biography` string, nullable
    - `follower_count` number, nullable
    - `following_count` number, nullable
    - `post_count` number, nullable
    - `list_count` number, nullable
    - `feed_count` number, nullable
    - `starter_pack_count` number, nullable
    - `is_verified` boolean, nullable
    - `is_labeler` boolean, nullable
    - `profile_pic_url` string, nullable
    - `profile_banner_url` string, nullable
    - `date_joined` string, nullable
    - `date_joined_timestamp` number, nullable
    - `pinned_post_id` string, nullable
    - `url` string, nullable

## Other responses

- `400`: Bad request: a required parameter is missing or a value is invalid (code: missing_parameter or invalid_parameter).
- `401`: Unauthorized: the API key is missing or invalid (code: missing_api_key or invalid_api_key).
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: Not found: the user does not exist (code: not_found).
- `429`: Rate limit exceeded, or too many concurrent requests for this endpoint
- `500`: Internal server error
- `502`: Temporary failure retrieving Bluesky data. Please retry shortly.
- `503`: Service unavailable: the data source is temporarily unavailable
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)