app.bsky.actor.searchActors
GETapp.bsky.actor.searchActors
Find actors (profiles) matching search criteria. Does not require auth.
Request
Query Parameters
Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.
Possible values: >= 1
and <= 100
Default value: 25
Responses
- 200
- 400
- 401
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
Array [
]
Array [
]
]
actors
object[]
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all
, none
, following
]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty
and <= 64 characters
purpose
object
required
oneOf
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty
and <= 64 characters
purpose
object
required
oneOf
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
{
"cursor": "string",
"actors": [
{
"did": "string",
"handle": "string",
"displayName": "string",
"description": "string",
"avatar": "string",
"associated": {
"lists": 0,
"feedgens": 0,
"labeler": true,
"chat": {
"allowIncoming": "all"
}
},
"indexedAt": "2024-05-19T00:25:04.091Z",
"viewer": {
"muted": true,
"mutedByList": {
"uri": "string",
"cid": "string",
"name": "string",
"purpose": "string",
"avatar": "string",
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-05-19T00:25:04.092Z",
"exp": "2024-05-19T00:25:04.092Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-05-19T00:25:04.092Z"
},
"blockedBy": true,
"blocking": "string",
"blockingByList": {
"uri": "string",
"cid": "string",
"name": "string",
"purpose": "string",
"avatar": "string",
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-05-19T00:25:04.092Z",
"exp": "2024-05-19T00:25:04.092Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-05-19T00:25:04.092Z"
},
"following": "string",
"followedBy": "string"
},
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-05-19T00:25:04.092Z",
"exp": "2024-05-19T00:25:04.092Z",
"sig": "string"
}
]
}
]
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [InvalidRequest
, ExpiredToken
, InvalidToken
]
{
"error": "InvalidRequest",
"message": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string"
}