app.bsky.actor.get Suggestions

GET {{baseUrl}}/xrpc/app.bsky.actor.getSuggestions?limit=50&cursor=<string>

This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.`). Public endpoints which don't require authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated requests are usually made to the user's PDS, with automatic service proxying. Authenticated requests can be used for both public and non-public endpoints.*

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

Get a list of suggested actors. Expected use is discovery of accounts to follow during new account onboarding.

Request Params

HEADERS

RESPONSES

status: OK

{"actors":[{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","description":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":"\u003cstring\u003e"}},"indexedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","viewer":{"muted":"\u003cboolean\u003e","mutedByList":{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","name":"\u003cstring\u003e","purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":"\u003curi\u003e","listItemCount":"\u003cinteger\u003e","labels":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"viewer":{"muted":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"blocked":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"indexedAt":"\u003cdateTime\u003e"},"blockedBy":"\u003cboolean\u003e","blocking":"\u003cat-uri\u003e","blockingByList":{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","name":"\u003cstring\u003e","purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":"\u003curi\u003e","listItemCount":"\u003cinteger\u003e","labels":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"viewer":{"muted":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"blocked":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"indexedAt":"\u003cdateTime\u003e"},"following":"\u003cat-uri\u003e","followedBy":"\u003cat-uri\u003e","knownFollowers":{"count":"\u003cinteger\u003e","followers":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]}},"labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]},{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","description":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":"\u003cstring\u003e"}},"indexedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","viewer":{"muted":"\u003cboolean\u003e","mutedByList":{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","name":"\u003cstring\u003e","purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":"\u003curi\u003e","listItemCount":"\u003cinteger\u003e","labels":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"viewer":{"muted":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"blocked":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"indexedAt":"\u003cdateTime\u003e"},"blockedBy":"\u003cboolean\u003e","blocking":"\u003cat-uri\u003e","blockingByList":{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","name":"\u003cstring\u003e","purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":"\u003curi\u003e","listItemCount":"\u003cinteger\u003e","labels":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"viewer":{"muted":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"blocked":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"indexedAt":"\u003cdateTime\u003e"},"following":"\u003cat-uri\u003e","followedBy":"\u003cat-uri\u003e","knownFollowers":{"count":"\u003cinteger\u003e","followers":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]}},"labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]}],"cursor":"\u003cstring\u003e"}