# Bluesky API: Get profile

> Looks up a public Bluesky profile by handle or profile link, including bio, audience counts and join date. A bare name first checks its .bsky.social handle, then the top relevant people-search result.

Unofficial. Not affiliated with or endorsed by Bluesky.

- Page: https://fous.com/methods/bsky.app/get-profile
- Method: `bsky.app/get_profile`, version 1
- Website: bsky.app
- Returns: handle, display name, bio, followers, following, post count, joined date, avatar link, profile link, DID
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `username` | string | yes | `"nytimes"` | Account handle with or without @, a Bluesky profile link, or a bare name such as nytimes. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "username": "nytimes"
}
```

Its output:

```json
{
  "bio": "We seek the truth and help people understand the world. Not a subscriber? Your first month is now free in our app. https://nytimes.onelink.me/Xpht/zbx4nci9",
  "did": "did:plc:eclio37ymobqex2ncko63h4r",
  "handle": "@nytimes.com",
  "followers": 1353269,
  "following": 123,
  "joined_date": "2023-06-05",
  "display_name": "The New York Times",
  "profile_link": "https://bsky.app/profile/nytimes.com",
  "number_of_posts": 44611,
  "avatar_image_link": "https://cdn.bsky.app/img/avatar/plain/did:plc:eclio37ymobqex2ncko63h4r/bafkreidvvqj5jymmpaeklwkpq6gi532el447mjy2yultuukypzqm5ohfju"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"bsky.app/get_profile","input":{"username":"nytimes"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Can you pull up the Bluesky profile for @nytimes and tell me how many followers it has?
- I want to see the bio and join date for the bsky.social account jack.
- Look up the Bluesky profile at https://bsky.app/profile/bsky.app and give me its DID and post count.
- What's the display name and following count for the handle @atproto.bsky.social?
- Find the Bluesky account for a person named Maria Lopez and show me her avatar and profile link.

## Input schema

```json
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "examples": [
        "nytimes"
      ],
      "description": "Account handle with or without @, a Bluesky profile link, or a bare name such as nytimes."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "handle",
    "display_name",
    "bio",
    "followers",
    "following",
    "number_of_posts",
    "joined_date",
    "avatar_image_link",
    "profile_link",
    "did"
  ],
  "properties": {
    "bio": {
      "type": [
        "string",
        "null"
      ],
      "description": "Profile biography."
    },
    "did": {
      "type": "string",
      "description": "The account's decentralized identifier.",
      "x-fous-developer": true
    },
    "handle": {
      "type": "string",
      "description": "Account handle, with @."
    },
    "followers": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of followers."
    },
    "following": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of accounts followed."
    },
    "joined_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date the public profile was created, YYYY-MM-DD."
    },
    "display_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Name displayed on the profile."
    },
    "profile_link": {
      "type": "string",
      "description": "Link to the Bluesky profile."
    },
    "number_of_posts": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of posts."
    },
    "avatar_image_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Link to the profile avatar image."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Bluesky API: List recent posts](https://fous.com/methods/bsky.app/list-recent-posts.md): Lists an account's latest public Bluesky posts, newest first. Replies and reposts are left out unless requested; a repost's time is when the account reposted it.
- [Bluesky API: Search posts](https://fous.com/methods/bsky.app/search-posts.md): Searches public Bluesky posts for words, optionally ordered by latest or top and filtered by date, author or language. Search indexing may lag behind new posts.
- [X API: Get profile](https://fous.com/methods/x.com/get-profile.md): Gets the public X profile for a username or profile link, including counts, verification, images and account details. Does not include posts or a timeline.
- [Mastodon API: Get profile](https://fous.com/methods/mastodon.social/get-profile.md): Gets a public Mastodon profile by handle or profile link, with its bio, counts, dates and profile fields. Major servers are read directly. Other servers are looked up through mastodon.social, and their home-server account ID is not available.
- [TikTok API: Get profile](https://fous.com/methods/tiktok.com/get-profile.md): Gets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned.
- [Social Blade API: Get Instagram account stats](https://fous.com/methods/socialblade.com/get-instagram-stats.md): Looks up public Instagram account totals, engagement and grade on Social Blade by handle or profile link. Daily history and 30-day follower change need a Social Blade sign-in, so they are not returned.
- [Threads API: Get profile](https://fous.com/methods/threads.com/get-profile.md): Gets a public Threads profile by username or profile link, with bio, followers, verification, picture and bio links. Private profiles are not returned.
- [Social Blade API: Get TikTok creator stats](https://fous.com/methods/socialblade.com/get-tiktok-stats.md): Gets a TikTok creator's Social Blade profile totals, grade when shown, 30-day follower and like changes, and up to 14 days of daily totals, from a TikTok handle or a TikTok or Social Blade profile link. Counts reflect Social Blade's recorded and sometimes rounded figures.
- [All Bluesky methods](https://fous.com/methods/bsky.app.md)