place.stream.live.getRecommendations Documentation (EN)

main query

Get the list of streamers recommended by a user

Parameters

userDID string did Required

The DID of the user whose recommendations to fetch

Output

Encodingapplication/json

recommendations array Required

Ordered list of recommendations

userDID stringdid Optional

The user DID this recommendation is for

Try It

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

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

userDID * The DID of the user whose recommendations to fetch

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "recommendations"
      ],
      "properties": {
        "userDID": {
          "type": "string",
          "format": "did",
          "description": "The user DID this recommendation is for"
        },
        "recommendations": {
          "type": "array",
          "items": {
            "refs": [
              "#livestreamRecommendation"
            ],
            "type": "union"
          },
          "description": "Ordered list of recommendations"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "userDID"
    ],
    "properties": {
      "userDID": {
        "type": "string",
        "format": "did",
        "description": "The DID of the user whose recommendations to fetch"
      }
    }
  },
  "description": "Get the list of streamers recommended by a user"
}

livestreamRecommendation object

No description available.

Properties

did string did Required

The DID of the recommended streamer

source string Required

Source of the recommendation

View raw schema

{
  "type": "object",
  "required": [
    "did",
    "source"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "The DID of the recommended streamer"
    },
    "source": {
      "enum": [
        "streamer",
        "follows",
        "host"
      ],
      "type": "string",
      "description": "Source of the recommendation"
    }
  }
}