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

  • artistsTitle: Human readable artists String
  • catalogId: Monstercat's readable release ID (MCEPxxx; MCSxxx etc...)
  • downloadable
  • genrePrimary / genreSecondary
  • id: Internal unique ID
  • inEarlyAccess
  • releaseDate: ISO 8601 date/time (UTC-5) of release. Includes timezone.
  • streamable
  • title: Human readable string containing the release title
  • type: Single, EP, LP...
  • version: Unnused

Track object

  • artists: numeric array containing artists linked to the track entry. Also contains the remixers, vocalists...
    • see Artist object
  • artistsTitle: Human-readable artist field (String)
  • bpm: Beats per minute (Integer)
  • creatorFriendly: Is track allowed for licensing ? (boolean)
  • debutDate: ISO 8601 date/time (UTC-5) of release. Timezone is after time, formatted like +/-hh:mm (%yyyy-%mm-%ddT%hh:%mm:%ss%+/-timezonehh:timezonemm)
  • downloadable: Is track currently downloadable or in gold preview ? (boolean)
  • duration: track length in seconds (integer)
  • explicit: if the track contains swear words (boolean)
  • genrePrimary / genreSecondary: Genre strings, genrePrimary is mostly Dance, while genreSecondary represents genres like DnB, Electro... (String)
  • id: unique track identifier
  • inEarlyAccess: is the track reserved to gold ?
  • isrc: international release ID, ISO 3901.
  • release: Object, which is the release that contains this track.
    • see Release object
  • streamable: Can track be played through the API ?
  • tags: numeric array containing strings which defines the track.
  • tracknumber: Track numbering in the corresponding release
  • version: can include remixes, VIP, Acoustic...

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