app.bsky.actor.search Actors Typeahead

GET {{baseUrl}}/xrpc/app.bsky.actor.searchActorsTypeahead?q=<string>&limit=10

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.

Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require auth.

Request Params

HEADERS

RESPONSES

status: OK

{"actors":[{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":"\u003cstring\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":"\u003cCircular reference to #/components/schemas/app.bsky.actor.defs.profileViewBasic detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/app.bsky.actor.defs.profileViewBasic detected\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"}],"createdAt":"\u003cdateTime\u003e"},{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":"\u003cstring\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":"\u003cCircular reference to #/components/schemas/app.bsky.actor.defs.profileViewBasic detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/app.bsky.actor.defs.profileViewBasic detected\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"}],"createdAt":"\u003cdateTime\u003e"}]}