social.grain.unspecced.getFollowers

grain.social

Documentation

Get followers for a given user.

main query

Get followers for a given user.

Parameters

actor string at-identifier Required

Either a DID or an AT Protocol handle.

cursor string Optional

No description available.

limit integer Optional

No description available.

viewer string did Optional

A decentralized identifier (DID).

Output

Encodingapplication/json
cursor string Optional

No description available.

items array Optional

No description available.

totalCount integer Optional

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Either a DID or an AT Protocol handle.
A decentralized identifier (DID).
View raw schema 
{
  "description": "Get followers for a given user.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "type": "string"
        },
        "items": {
          "items": {
            "ref": "social.grain.unspecced.getFollowers#followerItem",
            "type": "ref"
          },
          "type": "array"
        },
        "totalCount": {
          "type": "integer"
        }
      },
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "actor": {
        "format": "at-identifier",
        "type": "string"
      },
      "cursor": {
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "viewer": {
        "format": "did",
        "type": "string"
      }
    },
    "required": [
      "actor"
    ],
    "type": "params"
  },
  "type": "query"
}
followerItem object

No description available.

Properties

avatar string Optional

No description available.

description string Optional

No description available.

did string did Required

A decentralized identifier (DID).

displayName string Optional

No description available.

handle string Optional

No description available.

View raw schema 
{
  "properties": {
    "avatar": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "did": {
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "viewer": {
      "ref": "social.grain.unspecced.getFollowers#viewerState",
      "type": "ref"
    }
  },
  "required": [
    "did"
  ],
  "type": "object"
}
viewerState object

No description available.

Properties

following string at-uri Optional

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "properties": {
    "following": {
      "format": "at-uri",
      "type": "string"
    }
  },
  "type": "object"
}

Lexicon Garden

@