social.showcase.library.listItems Documentation (EN)

main query

List user's items. Authentication optional - returns personalized view when authenticated (includes private items for own account).

Parameters

actor string at-identifier Required

The DID or handle of the user

cursor string Optional

Pagination cursor

limit integer Optional

No description available.

Output

Encodingapplication/json

cursor string Optional

No description available.

items array Required

No description available.

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

actor * The DID or handle of the user

cursor Pagination cursor

limit

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "items"
      ],
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "ref": "social.showcase.defs#itemView",
            "type": "ref"
          }
        },
        "cursor": {
          "type": "string",
          "maxLength": 512
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor"
    ],
    "properties": {
      "actor": {
        "type": "string",
        "format": "at-identifier",
        "description": "The DID or handle of the user"
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Pagination cursor"
      }
    }
  },
  "description": "List user's items. Authentication optional - returns personalized view when authenticated (includes private items for own account)."
}