# app.rocksky.artist.defs

> Published by [rocksky.app](https://lexicon.garden/identity/did:plc:vegqomyce4ssoqs7zwqvgqty)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.artist.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.artist.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.artist.defs/examples)

## Definitions

### `app.rocksky.artist.defs#artistMbid`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `mbid` | `string` | No | The MusicBrainz Identifier (MBID) of the artist. |
| `name` | `string` | No | The name of the artist. |

### `app.rocksky.artist.defs#songViewBasic`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (at-uri) | No | The URI of the song. |
| `title` | `string` | No | The title of the song. |
| `playCount` | `integer` | No | The number of times the song has been played. |

### `app.rocksky.artist.defs#artistViewBasic`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | No | The unique identifier of the artist. |
| `uri` | `string` (at-uri) | No | The URI of the artist. |
| `name` | `string` | No | The name of the artist. |
| `tags` | `array` | No |  |
| `sha256` | `string` | No | The SHA256 hash of the artist. |
| `picture` | `string` | No | The picture of the artist. |
| `playCount` | `integer` | No | The number of times the artist has been played. |
| `uniqueListeners` | `integer` | No | The number of unique listeners who have played the artist. |

### `app.rocksky.artist.defs#listenerViewBasic`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | No | The unique identifier of the actor. |
| `did` | `string` | No | The DID of the listener. |
| `rank` | `integer` | No | The rank of the listener among all listeners of the artist. |
| `avatar` | `string` (uri) | No | The URL of the listener's avatar image. |
| `handle` | `string` | No | The handle of the listener. |
| `totalPlays` | `integer` | No | The total number of plays by the listener. |
| `displayName` | `string` | No | The display name of the listener. |
| `mostListenedSong` | `ref` → `app.rocksky.artist.defs#songViewBasic` | No |  |

### `app.rocksky.artist.defs#artistViewDetailed`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | No | The unique identifier of the artist. |
| `uri` | `string` (at-uri) | No | The URI of the artist. |
| `name` | `string` | No | The name of the artist. |
| `tags` | `array` | No |  |
| `sha256` | `string` | No | The SHA256 hash of the artist. |
| `picture` | `string` | No | The picture of the artist. |
| `playCount` | `integer` | No | The number of times the artist has been played. |
| `uniqueListeners` | `integer` | No | The number of unique listeners who have played the artist. |

## Raw Schema

```json
{
  "id": "app.rocksky.artist.defs",
  "defs": {
    "artistMbid": {
      "type": "object",
      "properties": {
        "mbid": {
          "type": "string",
          "description": "The MusicBrainz Identifier (MBID) of the artist."
        },
        "name": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1,
          "description": "The name of the artist."
        }
      }
    },
    "songViewBasic": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "The URI of the song."
        },
        "title": {
          "type": "string",
          "description": "The title of the song."
        },
        "playCount": {
          "type": "integer",
          "minimum": 0,
          "description": "The number of times the song has been played."
        }
      }
    },
    "artistViewBasic": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier of the artist."
        },
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "The URI of the artist."
        },
        "name": {
          "type": "string",
          "description": "The name of the artist."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "sha256": {
          "type": "string",
          "description": "The SHA256 hash of the artist."
        },
        "picture": {
          "type": "string",
          "description": "The picture of the artist."
        },
        "playCount": {
          "type": "integer",
          "minimum": 0,
          "description": "The number of times the artist has been played."
        },
        "uniqueListeners": {
          "type": "integer",
          "minimum": 0,
          "description": "The number of unique listeners who have played the artist."
        }
      }
    },
    "listenerViewBasic": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier of the actor."
        },
        "did": {
          "type": "string",
          "description": "The DID of the listener."
        },
        "rank": {
          "type": "integer",
          "minimum": 1,
          "description": "The rank of the listener among all listeners of the artist."
        },
        "avatar": {
          "type": "string",
          "format": "uri",
          "description": "The URL of the listener's avatar image."
        },
        "handle": {
          "type": "string",
          "description": "The handle of the listener."
        },
        "totalPlays": {
          "type": "integer",
          "minimum": 0,
          "description": "The total number of plays by the listener."
        },
        "displayName": {
          "type": "string",
          "description": "The display name of the listener."
        },
        "mostListenedSong": {
          "ref": "app.rocksky.artist.defs#songViewBasic",
          "type": "ref"
        }
      }
    },
    "artistViewDetailed": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier of the artist."
        },
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "The URI of the artist."
        },
        "name": {
          "type": "string",
          "description": "The name of the artist."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "sha256": {
          "type": "string",
          "description": "The SHA256 hash of the artist."
        },
        "picture": {
          "type": "string",
          "description": "The picture of the artist."
        },
        "playCount": {
          "type": "integer",
          "minimum": 0,
          "description": "The number of times the artist has been played."
        },
        "uniqueListeners": {
          "type": "integer",
          "minimum": 0,
          "description": "The number of unique listeners who have played the artist."
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```