fm.teal.stats.getUserTopArtists Documentation (EN)

main query

No description available.

Parameters

actor string at-identifier Required

The user's DID or handle

cursor string Optional

Pagination cursor

limit integer Optional

Number of artists to return

period string Optional

Time period for top artists

Output

Encodingapplication/json

artists array Required

No description available.

cursor string Optional

Next page cursor

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 user's DID or handle

cursor Pagination cursor

limit Number of artists to return

period Time period for top artists

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "artists"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Next page cursor"
        },
        "artists": {
          "type": "array",
          "items": {
            "ref": "fm.teal.stats.defs#artistView",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor"
    ],
    "properties": {
      "actor": {
        "type": "string",
        "format": "at-identifier",
        "description": "The user's DID or handle"
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Number of artists to return"
      },
      "cursor": {
        "type": "string",
        "description": "Pagination cursor"
      },
      "period": {
        "enum": [
          "30days",
          "7days"
        ],
        "type": "string",
        "default": "30days",
        "description": "Time period for top artists"
      }
    }
  }
}