community.gifthood.graph.getKnownFollowers

gifthood.community

Documentation

Return the count and a sample of accounts the authenticated viewer follows who also follow the given subject. Viewer-relative: requires authentication (AuthRequired when logged out). A block in either direction between the viewer and the subject returns Unavailable. The count may exceed the returned sample (capped by limit).

main query

Return the count and a sample of accounts the authenticated viewer follows who also follow the given subject. Viewer-relative: requires authentication (AuthRequired when logged out). A block in either direction between the viewer and the subject returns Unavailable. The count may exceed the returned sample (capped by limit).

Parameters

actor string did Required

DID of the subject account.

limit integer Optional

Maximum number of known followers to return in the sample.

Output

Encodingapplication/json
count integer Required

Total number of accounts the viewer follows who also follow the subject; may exceed the returned sample.

followers array Required

A sample (≤ limit) of known followers, each a medium profileView.

Errors

AuthRequired The caller is not authenticated; known-follower lookup is viewer-relative and requires a session.
Unavailable A block exists in either direction between the viewer and the subject account; the known-follower list is not 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
DID of the subject account.
Maximum number of known followers to return in the sample.
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "AuthRequired",
      "description": "The caller is not authenticated; known-follower lookup is viewer-relative and requires a session."
    },
    {
      "name": "Unavailable",
      "description": "A block exists in either direction between the viewer and the subject account; the known-follower list is not available."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "count",
        "followers"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "Total number of accounts the viewer follows who also follow the subject; may exceed the returned sample."
        },
        "followers": {
          "type": "array",
          "items": {
            "ref": "community.gifthood.actor.defs#profileView",
            "type": "ref"
          },
          "description": "A sample (≤ limit) of known followers, each a medium profileView."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor"
    ],
    "properties": {
      "actor": {
        "type": "string",
        "format": "did",
        "description": "DID of the subject account."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of known followers to return in the sample."
      }
    }
  },
  "description": "Return the count and a sample of accounts the authenticated viewer follows who also follow the given subject. Viewer-relative: requires authentication (AuthRequired when logged out). A block in either direction between the viewer and the subject returns Unavailable. The count may exceed the returned sample (capped by limit)."
}

Lexicon Garden

@