Query Reference

GetPlaylist

Generate a playlist based on the given tags

Request URL /GetPlaylist
Verb GET
Properties
NameDescription
albumIdThe ID of an album from a external service. Can be used instead of providing a MusicGeek tag for an album
albumIdTypeThe type of external album ID provided
Valid values are:
  • CatalogNumber - Catalog number issued by the label.
  • DiscogsMaster - Discogs Master ID.
  • DiscogsRelease - Discocs Release ID.
  • EAN - International Article Number.
  • FreeDb - Disk checksum in FreeDB database.
  • Internal - Album ID given out by this service.
  • MusicBrainz - MusicBrainz Release Group ID.
  • Spotify - Spotify Album ID.
artistIdThe ID of an artist from a external service. Can be used instead of providing a MusicGeek tag for an artist
artistIdTypeThe type of external artist ID provided
Valid values are:
  • DiscogsArtist - Discogs Artist ID.
  • Internal - Artist ID given out by this service.
  • MusicBrainz - MusicBrainz Artist ID.
  • Spotify - Spotify Artist ID.
depthThe recordings in the resultset have these additional details.
Valid values are:
  • ArtistDetails - Detail of the main Artists on each recording.
  • ConstituentRecordings - Recordings that this recording is made up of.
  • Genres - Genres associated with each recording.
  • Identifiers - RecordingIdentifiers associated with each artist.
  • Participations - Participations associated with the recording.
  • SessionInfo - ProductionEvents associated with the production of each recording.
  • Works - Works that are being performed on each recording.
playlistSizeThe maximum amount of songs desired in the playlist. From 1 to 20. Default is 10
recordingIdThe ID of an recording from a external service. Can be used instead of providing a MusicGeek tag for an recording
recordingIdTypeThe type of external recording ID provided
Valid values are:
  • Deezer - Deezer Recording ID.
  • Internal - Recording ID given out by this service.
  • ISRC - International Standard Recording Code.
  • MusicBrainz - MusicBrainz Recording ID.
  • SofarShowNumber - The number of the Sofar show that this recording was part of.
  • SoundPrint - MusicDNS Soundprint.
  • Spotify - Spotify Track ID.
  • Youtube
tagThe MusicGeek tag ids of the tags to base the playlist on

PostFeedback

Provide feedback about a song in the playlist

Request URL /PostFeedback
Verb GET
Returns HttpResponseMessage
Properties
NameDescription
playlistIdThe ID of the playlist
positionThe position of the song on the playlist
rating-1 for a negative feedback, 0 for neutral, 1 for positive

SearchTags

Get a collection of tags that match the given search criteria

Request URL /SearchTags
Verb GET
Returns TagQueryResult
Properties
NameDescription
albumIdsBy ID search of album tags
albumIdType>The type of external album ID provided
Valid values are:
  • CatalogNumber - Catalog number issued by the label.
  • DiscogsMaster - Discogs Master ID.
  • DiscogsRelease - Discocs Release ID.
  • EAN - International Article Number.
  • FreeDb - Disk checksum in FreeDB database.
  • Internal - Album ID given out by this service.
  • MusicBrainz - MusicBrainz Release Group ID.
  • Spotify - Spotify Album ID.
albumsText search of album tags
albumSearchTypeThe type of text search given in the 'albums' field
Valid values are:
  • FullName - Names exactly matching the term.
  • PartialName - Names containing the term.
artistIdsBy ID search of artist tags
artistIdTypeThe type of external artist ID provided
Valid values are:
  • DiscogsArtist - Discogs Artist ID.
  • Internal - Artist ID given out by this service.
  • MusicBrainz - MusicBrainz Artist ID.
  • Spotify - Spotify Artist ID.
artistsText search of artist tags
artistSearchTypeThe type of text search given in the 'artists' field
Valid values are:
  • FullName - Names exactly matching the term.
  • PartialName - Names containing the term.
genresText search of genre tags
locationsText search of location tags
maxThe maximum number of tags to return. Default is 100
onlyReturnMusicGeekEntitiesThe resultset contains only entities which can be used in MusicGeek
recordingIdsBy ID search of recording tags
recordingIdTypeThe type of external recording ID provided
Valid values are:
  • Deezer - Deezer Recording ID.
  • Internal - Recording ID given out by this service.
  • ISRC - International Standard Recording Code.
  • MusicBrainz - MusicBrainz Recording ID.
  • SofarShowNumber - The number of the Sofar show that this recording was part of.
  • SoundPrint - MusicDNS Soundprint.
  • Spotify - Spotify Track ID.
  • Youtube
recordingsText search of recording tags
recordingSearchTypeThe type of text search in the 'recordings' field
Valid values are:
  • FullName - Names exactly matching the term.
  • PartialName - Names containing the term.
specialTagsList all special tags of the given type
textText search of all tag types

Object Model Reference

PlaylistEntry

A song in a playlist

Class PlaylistEntry
Parameters
NameResultObjectDescription
EvidencePlaylistEntryEvidence[] Detailed reasons as to why this song was included in the playlist
Positionint The song's position within the playlist
PrimarySourceSource The main source of information that caused this song to be recommended
ReasonSummarystring A one or two sentance summary of why this song was included in the playlist
RecordingRecording Metadata about the song

PlaylistEntryEvidence

Detailed reason as to why a song was included in a playlist

Class PlaylistEntryEvidence
Parameters
NameResultObjectDescription
Positionint Where this evidence ranks compared to other evidences for this song. 1st position is best
Reasonstring A literal reason describing why the song was chosen
ReasonLinkString A link to the article where this evidence was found
ReasonQuantoneIdGuid? The Quantone ID of another entity that this reason refers to
SourceSource The source of this evidence

PlaylistQueryResult

A playlist generated by MusicGeek

Class PlaylistQueryResult
Parameters
NameResultObjectDescription
PlaylistEntriesPlaylistEntry[] The recordings in this playlist
PlaylistIdGuid The id of the playlist
SearchTagsTag[] The tags used to make this playlist

Status

Information about the response

Class Status
Parameters
NameResultObjectDescription
ErrorCodeint? The code for any errors
HasErrorbool Whether or not the response contains any errors
Messagestring A message about the response

Tag

A MusicGeek tag

Class Tag
Parameters
NameResultObjectDescription
Idstring The ID of the tag
Typestring The type of tag this is
Valuestring The display value of the tag

TagQueryResult

The result of a TagSearchQuery

Class TagQueryResult
Parameters
NameResultObjectDescription
TagsTag[] A collection of tags