town.delve.unspecced.getSuggestionsSkeleton

delve.town

Documentation

Get a skeleton of suggested actors. Intended to be called and then hydrated through app.bsky.actor.getSuggestions

main query

Get a skeleton of suggested actors. Intended to be called and then hydrated through app.bsky.actor.getSuggestions

Parameters

cursor string Optional

No description available.

limit integer Optional

No description available.

relativeToDid string did Optional

DID of the account to get suggestions relative to. If not provided, suggestions will be based on the viewer.

viewer string did Optional

DID of the account making the request (not included for public/unauthenticated queries). Used to boost followed accounts in ranking.

Output

Encodingapplication/json
actors array Required

No description available.

cursor string Optional

No description available.

recId integer Optional

DEPRECATED: use recIdStr instead.

recIdStr string Optional

Snowflake for this recommendation, use when submitting recommendation events.

relativeToDid stringdid Optional

DID of the account these suggestions are relative to. If this is returned undefined, suggestions are based on the viewer.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
DID of the account to get suggestions relative to. If not provided, suggestions will be based on the viewer.
DID of the account making the request (not included for public/unauthenticated queries). Used to boost followed accounts in ranking.
View raw schema
{
  "description": "Get a skeleton of suggested actors. Intended to be called and then hydrated through app.bsky.actor.getSuggestions",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "actors": {
          "items": {
            "ref": "town.delve.unspecced.defs#skeletonSearchActor",
            "type": "ref"
          },
          "type": "array"
        },
        "cursor": {
          "type": "string"
        },
        "recId": {
          "description": "DEPRECATED: use recIdStr instead.",
          "type": "integer"
        },
        "recIdStr": {
          "description": "Snowflake for this recommendation, use when submitting recommendation events.",
          "type": "string"
        },
        "relativeToDid": {
          "description": "DID of the account these suggestions are relative to. If this is returned undefined, suggestions are based on the viewer.",
          "format": "did",
          "type": "string"
        }
      },
      "required": [
        "actors"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "relativeToDid": {
        "description": "DID of the account to get suggestions relative to. If not provided, suggestions will be based on the viewer.",
        "format": "did",
        "type": "string"
      },
      "viewer": {
        "description": "DID of the account making the request (not included for public/unauthenticated queries). Used to boost followed accounts in ranking.",
        "format": "did",
        "type": "string"
      }
    },
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@