community.gifthood.graph.getFollows Documentation (EN)

main query

Enumerate the accounts that the given account follows, newest-first. Each row is a medium profileView (identity + the viewer's per-row follow-state). Public; a block in either direction between the viewer and the subject returns Unavailable.

Parameters

actor string did Required

DID of the subject account whose follows to list.

cursor string Optional

Opaque keyset cursor from a previous page. Absent for the first page.

limit integer Optional

Maximum rows per page.

Output

Encodingapplication/json

cursor string Optional

Opaque cursor for the next page; absent at the end.

follows array Required

The accounts the subject follows, newest-first.

Errors

Unavailable A block exists in either direction between the viewer and the subject account; the follow list is not available.

NotAvailableToPublic The author hides their content from logged-out viewers; sign in to view.

Try It

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

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

actor * DID of the subject account whose follows to list.

cursor Opaque keyset cursor from a previous page. Absent for the first page.

limit Maximum rows per page.

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "Unavailable",
      "description": "A block exists in either direction between the viewer and the subject account; the follow list is not available."
    },
    {
      "name": "NotAvailableToPublic",
      "description": "The author hides their content from logged-out viewers; sign in to view."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "follows"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Opaque cursor for the next page; absent at the end."
        },
        "follows": {
          "type": "array",
          "items": {
            "ref": "community.gifthood.actor.defs#profileView",
            "type": "ref"
          },
          "description": "The accounts the subject follows, newest-first."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor"
    ],
    "properties": {
      "actor": {
        "type": "string",
        "format": "did",
        "description": "DID of the subject account whose follows to list."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum rows per page."
      },
      "cursor": {
        "type": "string",
        "description": "Opaque keyset cursor from a previous page. Absent for the first page."
      }
    }
  },
  "description": "Enumerate the accounts that the given account follows, newest-first. Each row is a medium profileView (identity + the viewer's per-row follow-state). Public; a block in either direction between the viewer and the subject returns Unavailable."
}