Users

Get my profile

get

Returns the profile of the authenticated user.

Query parameters

includeStatsboolean · nullableOptional

Header parameters

X-Semble-ClientstringOptional

A short identifier for your integration (e.g. my-plugin, mcp). Please set this if you are building an integration — it helps Semble understand which tools people use. Values are lowercased before being recorded, so MyPlugin and myplugin are the same client. After lowercasing the value must match ^[a-z0-9][a-z0-9_-]{0,31}$; values that do not are ignored, and the client is inferred from the auth method instead.

Example: my-pluginPattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$

Responses

200

200

application/json

idstringRequired

namestringRequired

handlestringRequired

avatarUrlstringOptional

bannerUrlstringOptional

descriptionstringOptional

isFollowingbooleanOptional

isSubscribedbooleanOptional

followsYoubooleanOptional

followerCountnumberOptional

followingCountnumberOptional

followedCollectionsCountnumberOptional

urlCardCountnumberOptional

collectionCountnumberOptional

connectionCountnumberOptional

get/network.cosmik.actor.getMyProfile

GET /xrpc/network.cosmik.actor.getMyProfile HTTP/1.1
Host: api.semble.so
Accept: */*

200

200

{
  "id": "text",
  "name": "text",
  "handle": "text",
  "avatarUrl": "text",
  "bannerUrl": "text",
  "description": "text",
  "isFollowing": true,
  "isSubscribed": true,
  "subscriptionScopes": [
    "CARD"
  ],
  "followsYou": true,
  "followerCount": 1,
  "followingCount": 1,
  "followedCollectionsCount": 1,
  "urlCardCount": 1,
  "collectionCount": 1,
  "connectionCount": 1,
  "connectionsByType": {
    "total": 1,
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "labels": [
    {
      "$type": "com.atproto.label.defs#label",
      "ver": 1,
      "src": "text",
      "uri": "text",
      "cid": "text",
      "val": "text",
      "neg": true,
      "cts": "text",
      "exp": "text",
      "sig": null
    }
  ]
}

Get a user profile

get

Returns the public profile of a user, identified by handle or DID.

Query parameters

identifierstringRequired

includeStatsboolean · nullableOptional

Header parameters

X-Semble-ClientstringOptional

A short identifier for your integration (e.g. my-plugin, mcp). Please set this if you are building an integration — it helps Semble understand which tools people use. Values are lowercased before being recorded, so MyPlugin and myplugin are the same client. After lowercasing the value must match ^[a-z0-9][a-z0-9_-]{0,31}$; values that do not are ignored, and the client is inferred from the auth method instead.

Example: my-pluginPattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$

Responses

200

200

application/json

idstringRequired

namestringRequired

handlestringRequired

avatarUrlstringOptional

bannerUrlstringOptional

descriptionstringOptional

isFollowingbooleanOptional

isSubscribedbooleanOptional

followsYoubooleanOptional

followerCountnumberOptional

followingCountnumberOptional

followedCollectionsCountnumberOptional

urlCardCountnumberOptional

collectionCountnumberOptional

connectionCountnumberOptional

atprotoSessionValidbooleanOptional

get/network.cosmik.actor.getProfile

GET /xrpc/network.cosmik.actor.getProfile?identifier=text HTTP/1.1
Host: api.semble.so
Accept: */*

200

200

{
  "id": "text",
  "name": "text",
  "handle": "text",
  "avatarUrl": "text",
  "bannerUrl": "text",
  "description": "text",
  "isFollowing": true,
  "isSubscribed": true,
  "subscriptionScopes": [
    "CARD"
  ],
  "followsYou": true,
  "followerCount": 1,
  "followingCount": 1,
  "followedCollectionsCount": 1,
  "urlCardCount": 1,
  "collectionCount": 1,
  "connectionCount": 1,
  "connectionsByType": {
    "total": 1,
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "labels": [
    {
      "$type": "com.atproto.label.defs#label",
      "ver": 1,
      "src": "text",
      "uri": "text",
      "cid": "text",
      "val": "text",
      "neg": true,
      "cts": "text",
      "exp": "text",
      "sig": null
    }
  ],
  "atprotoSessionValid": true
}