Global JSON Objects

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

Field	Type	Description
Archived	boolean	Whether the playlist is archived
BackgroundFileId	string	ID of the background image asset
CreatedAt	ISO8601 timestamp	When the playlist was created
Description	string	The description of the playlist
Id	string	The unique ID of the playlist
IsPublic	boolean	Whether the playlist is public
Items	null	The items in the playlist (always null)
MyLibrary	boolean	Whether this is a user's library
NumRecords	integer	The amount of tracks in the playlist
TileFileId	string	ID of the tile image asset
Title	string	The title of the playlist
UpdatedAt	ISO8601 timestamp	When the playlist was last updated
UserId	string	The ID of the user who owns the playlist

Playlist Item Object

Field	Type	Description
PlaylistId	string	The ID of the playlist this item belongs to
ReleaseId	string	The ID of the release the track belongs to
Sort	integer	The index of the item in the playlist
TrackId	string	The ID of the track this item refers to

Release Object

Field	Type	Description
AlbumNotes?	string	Liner Notes for the release
Artists?	?array of release artist objects	Artists for the release
ArtistsTitle	string	Human readable artists string
BrandId?	integer	The ID of the brand the release belongs to
BrandTitle?	string	Human readable name of the brand the release belongs to
CatalogId	string	The catalog ID of the release
CopyrightPLine?	string	Notice of sound recording copyright (℗)
Description	string	Description of the release
Downloadable?	boolean	Whether the release can be downloaded with Gold
FeaturedArtistsTitle?	string	Human readable featured artists (unused?)
GRid?	string	The Global Release Identifier of the release
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
PrereleaseDate?	?ISO8601 timestamp	The pre-release date
PresaveDate?	?ISO8601 timestamp	The date when the release went up for presave
ReleaseDate	ISO8601 timestamp	The release date
ReleaseDateTimezone	string	Timezone identifier for the release date
SpotifyId?	?string	The spotify id for the release (see Links instead)
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
Tracks?	null	Tracks in the release (unused)
Type	string	The type of the release (Single, EP, Album, etc)
UPC?	string	The Universal Product Code code of the release
Version	string	The version of the release (shown in parentheses)
YoutubeUrl?	?string	The youtube video for the release (see Links instead)

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 International Standard Recording 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)

Release Artist Object

Field	Type	Description
ArtistId	string	Artist's unique id
ArtistNumber	integer	Artist's order in release credit
Name	string	Artist's name
ProfileFileId	string	ID of the profile image asset
Platform	string	Artist platform?
Public	boolean	Whether the artist's profile page is public
ReleaseId	string	ID of the release this artist is linked to
Role	string	Artist's role in the release
URI	string	Public url slug to the artist's profile page

Track Artist Object

Field	Type	Description
CatalogRecordId	string	ID of the track this artist is linked to
Id	string	Artist's unique id
Name	string	Artist's name
ProfileFileId	string	ID of the profile image asset
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

Settings object

Field	Type	Description
AutoEnableStreamerMode	boolean	Automatically enable creator safe mode when streaming (Streamlabs)
BlockUnlicensableTracks	boolean	Block unlicensable tracks from playing (creator safe mode)
HideUnlicensableTracks	boolean	Hide unlicensable tracks from view (creator safe mode)
StreamerMode?	boolean	Shortcut to set both creator safe mode settings at once
PlaylistPublicDefault	boolean	Make new playlists public by default
PreferredFormat	string	Format used to download tracks
SaySong?	boolean	Allows viewers to use the !song command in chat
AutoSaySong?	boolean	Automatically display the currently playing song in chat

User object

Field	Type	Description
Archived	boolean	Has the user been archived
Attributes.events	boolean	Get "Event announcements & info" notifications
Attributes.goldPerks	boolean	Get "Future gold updates & features" notifications
Attributes.merch	boolean	Get "Shop discounts & promotions" notifications
Attributes.news	boolean	Get "Monstercat news and special offers" notifications
AutoSaySong	boolean	Automatically display the currently playing song in chat
Birthday?	ISO8601 timestamp	User's birthday
City?	string	User's city
Continent?	string	user's continent
Country?	string	User's country
CreatedAt	ISO8601 timestamp	When the user's account was created
Email	string	User's email
EmailVerificationStatus	string	User's email verification status
Features	array	Unknown array about features the user has
FirstName	string	User's first name
FreeGold	boolean	Whether the user has a free gold subscription
FreeGoldAt	ISO8601 timestamp	When the user was granted free gold
FreeGoldReason	string	The reason the user has been granted free gold
GivenDownloadAccess	boolean	Whether the user has download access outside of gold
GoogleMapsPlaceId	string	Google maps ID for the user's location
HasDownload	boolean	Whether the user has download access
HasGold	boolean	Whether the user has gold
HasPassword	boolean	Whether the user has set a password
Id	string	ID of the user
LastName?	string	User's last name
LastSeen	ISO8601 timestamp	Last time the user has used the site
LastUpdateBenefitsGold	boolean	Unknown
LocationLat	double	Latitude of the user's location
LocationLng	double	Longitude of the user's location
MaxLicenses	integer	Maximum amount of licenses the user has
MyLibrary	string	ID of the user's My Library playlist
PlaceName	string	The name of the user's location
PlaceNameFull	string	The full name of the user's location
PlayerUUID	string	ID of the user's player for the Streaming Widget
Pronouns?	string	User's pronouns
ProvSt?	string	User's province or state
ProvinceState?	string	User's province or state
SaySong	boolean	Allows viewers to use the !song command in chat
Score	?	Unknown
Settings	settings object	User's saved settings for the player
TwoFactorId?	string	ID of the Authy 2FA
TwoFactorPendingId?	string	ID of the Authy 2FA that is pending verification
UpdatedAt	ISO8601 timestamp	When the user was last updated
Username	string	User's username

Error object

Field	Type	Description
Errors	null	There are currently no known cases where this is populated
Message	string	Error message
Name	string	Name of the error
StatusCode	integer	HTTP status code for the error