# Bluesky



Bluesky — an account's profile card, and its recent posts with likes, reposts, and replies.



## Bluesky Profile

A Bluesky account's card — display name, bio, avatar, follower and post counts — by handle.

- Method: `GET`
- Path: `/v1/social/bluesky/profile`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `handle` | string | required | Handle (`bsky.app`) or DID. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/social/bluesky/profile \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
    "handle": "bsky.app",
    "display_name": "Bluesky",
    "description": "The social internet is here.",
    "avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkrei…",
    "followers": 1284913,
    "follows": 3,
    "posts": 1240,
    "created_at": "2023-02-27T18:25:28.048Z"
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-23T12:30:00.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-23T12:45:00.000Z"
  }
}
```

**MCP**: callable from any AI agent via `call_api` with endpoint `bluesky-profile` — https://mcp.diraz.ae/mcp

## Bluesky Feed

A Bluesky account's recent posts — text, timestamps, likes, reposts, and replies — by handle.

- Method: `GET`
- Path: `/v1/social/bluesky/feed`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `handle` | string | required | Handle (`bsky.app`) or DID. |
| `limit` | integer | optional | Posts to return, 1 to 50. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/social/bluesky/feed \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "actor": "bsky.app",
    "posts": [
      {
        "uri": "at://did:plc:5amsebbtpuqieuxuqadmmvcv/app.bsky.feed.post/3mtm3ff75lc2d",
        "text": "We're hiring!",
        "author_handle": "debbieohi.com",
        "author_name": "Debbie Ridpath Ohi",
        "posted_at": "2026-08-22T10:14:00.000Z",
        "like_count": 214,
        "repost_count": 31,
        "reply_count": 12
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-23T12:30:00.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-23T12:35:00.000Z"
  }
}
```

**MCP**: callable from any AI agent via `call_api` with endpoint `bluesky-feed` — https://mcp.diraz.ae/mcp