app.rocksky.artist.getArtists Documentation (EN)

main query

Get artists

Parameters

genre string Optional

The genre to filter artists by

limit integer Optional

The maximum number of artists to return

names string Optional

The names of the artists to return

offset integer Optional

The offset for pagination

Output

Encodingapplication/json

artists array Optional

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

genre The genre to filter artists by

limit The maximum number of artists to return

names The names of the artists to return

offset The offset for pagination

View raw schema

{
  "description": "Get artists",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "artists": {
          "items": {
            "ref": "app.rocksky.artist.defs#artistViewBasic",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "genre": {
        "description": "The genre to filter artists by",
        "type": "string"
      },
      "limit": {
        "description": "The maximum number of artists to return",
        "minimum": 1,
        "type": "integer"
      },
      "names": {
        "description": "The names of the artists to return",
        "type": "string"
      },
      "offset": {
        "description": "The offset for pagination",
        "minimum": 0,
        "type": "integer"
      }
    },
    "type": "params"
  },
  "type": "query"
}