Skip to content

Global JSON Objects

Tonkku edited this page Sep 19, 2021 · 21 revisions

Artist Object

Field Type Description
About string Artist's about section for their page
FeaturedReleaseId string ID of artist's featured release
FeaturedVideoURL string URL to artist's featured video
Id string Artist's unique id
ImagePositionX integer Use currently unknown
ImagePositionY integer Use currently unknown
Links array of link objects Links to the artist's socials
Name string Artist's name
URI string Public url slug to the artist's profile page
Years array of integers Years when the artist has released on Monstercat

Link Object

Field Type Description
URL string The url this link leads to
Platform string The platform this link leads to

Playlist object

  • deleted: is the playlist in deletion state ?
  • createdAt: ISO 8601 datetime of creation without timezone and finished with Z
  • id: ID of the playlist
  • public: is the playlist viewable by someone else than you ?
  • myLibrary: is the playlist a my library collection (upcoming feature)
  • numRecords: amount of tracks in the playlist
  • name: Playlist name
  • updatedAt: ISO 8601 datetime recording the latest playlist update
  • userId: unique ID identifying the user that created the playlist

Playlist record object

  • trackId / releaseId: track and release IDs respectively
  • sort: 0-based index of the record in the playlist

Release Object

Field Type Description
ArtistsTitle string Human readable artists string
Brand? string The brand the release belongs to
CatalogId string The catalog ID of the release
Description string Description of the release
Downloadable? boolean Whether the release can be downloaded with Gold
GenrePrimary? string Primary genre of the release
GenreSecondary? string The subgenre of the release
Id string The unique ID of the release
InEarlyAccess? boolean Whether the release is currently in Gold Early Access
Links? array of link objects Links on this release
ReleaseDate ISO8601 timestamp The release date of the release
Streamable? boolean Whether the release can be streamed on the site/player
Tags? ?array of strings The tags of the release
Title string The title of the release
Type string The type of the release (Single, EP, Album, etc)
UPC? string The UPC code of the release
Version string The version of the release (shown in parentheses)
YoutubeUrl? string The youtube video for the release (currently unused)

Track Object

Field Type Description
Artists array of track artist objects The artists that produced the track
ArtistsTitle string Human readable artists string
BPM integer The track's BPM
Brand string The brand the track belongs to
BrandId integer The ID of the brand
CreatorFriendly boolean Whether the track is available for Content Creator licenses
DebutDate ISO8601 timestamp The first release date of the track
Downloadable boolean Whether the track can be downloaded with Gold
Duration integer The duration of the track in seconds
Explicit boolean Whether the track is explicit
GenrePrimary string Primary genre of the track
GenreSecondary string The subgenre of the track
ISRC string The ISRC code of the track
Id string The unique ID of the track
InEarlyAccess boolean Whether the track is currently in Gold Early Access
PlaylistSort integer The index of the track in a playlist
Release release object The release the track belongs to
Streamable boolean Whether the track can be streamed on the site/player
Tags ?array of strings The tags for the track
Title string The title of the track
TrackNumber integer The track number of the track in a release
Version string The version of the track (shown in parentheses)

Track Artist Object

Field Type Description
Id string Artist's unique id
Name string Artist's name
Public boolean Whether the artist's profile page is public
Role string Artist's role in the release
URI string Public url slug to the artist's profile page

Error object

  • message: simplified error message
  • name: User readable error
Clone this wiki locally