app.bsky.graph.getSuggestedFollowsByActor
GETapp.bsky.graph.getSuggestedFollowsByActor
Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.
Request
Query Parameters
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 [
]
]
suggestions
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.
{
"suggestions": [
{
"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:07.233Z",
"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:07.234Z",
"exp": "2024-05-19T00:25:07.234Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-05-19T00:25:07.234Z"
},
"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:07.234Z",
"exp": "2024-05-19T00:25:07.234Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-05-19T00:25:07.234Z"
},
"following": "string",
"followedBy": "string"
},
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-05-19T00:25:07.234Z",
"exp": "2024-05-19T00:25:07.234Z",
"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"
}