app.bsky.actor.search Actors

GET {{baseUrl}}/xrpc/app.bsky.actor.searchActors?q=<string>&limit=25&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.

Find actors (profiles) matching search criteria. Does not require auth.

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"}