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
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

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)
PlaylistPublicDefault	boolean	Make new playlists public by default
PreferredFormat	string	Format used to download tracks

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

• message: simplified error message
• name: User readable error