social.grain.unspecced.getSuggestedFollows

grain.social

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Get suggested profiles to follow based on bsky follow graph.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "items": {
              "items": {
                "ref": "social.grain.unspecced.getSuggestedFollows#suggestedItem",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "actor": {
            "format": "did",
            "type": "string"
          },
          "limit": {
            "default": 10,
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "actor"
        ],
        "type": "params"
      },
      "type": "query"
    },
    "suggestedItem": {
      "properties": {
        "avatar": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "did": {
          "format": "did",
          "type": "string"
        },
        "displayName": {
          "type": "string"
        },
        "followersCount": {
          "type": "integer"
        },
        "handle": {
          "type": "string"
        }
      },
      "required": [
        "did"
      ],
      "type": "object"
    }
  },
  "id": "social.grain.unspecced.getSuggestedFollows",
  "lexicon": 1
}

Validate Record

Validate a record against social.grain.unspecced.getSuggestedFollows

Validation Options
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:e7rftrdyz5e2rw4y6ocszew2
CID
bafyreiajaqflve6pofcbyalpsgt7thbmvhmgh54bjgepi3oztdkso7fzni
Indexed At
2026-10-31 17:04 UTC
AT-URI
at://did:plc:e7rftrdyz5e2rw4y6ocszew2/com.atproto.lexicon.schema/social.grain.unspecced.getSuggestedFollows

Similar Lexicons

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.

  • Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.

  • social.grain.unspecced.getKnownFollowers querynot from the namespace authority

    Get followers of a given actor that the viewer also follows.

  • town.delve.graph.getSuggestedFollowsByActor querynot from the namespace authority

    Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.

  • Get Actors the authenticated Member could follow next, and say where the list came from. When the Member's account is hosted somewhere other than this deployment's own PDS, their own app.bsky.graph.follow records are re…

Lexicon Garden

@