Export (0) Print
Expand All

Namespaces supported

The Xbox Music APIs use namespaces to indicate the type of content that is being referenced or asked for, and to separate ID spaces. All of the content IDs returned in content API responses are always prefixed with their namespace. For example, music.{ID} identifies a particular piece of music content. The namespaces should be considered as part of the ID when passing a specific ID in a request.

Some namespaces have associated sub-namespaces that can identify other secondary or third-party IDs for the same content types. For example, the music namespace is used to prefix Xbox Music IDs, but some of the Xbox Music pieces of content can also be referenced by third-party IDs such as AMG IDs (using the sub-namespace music.amg). Some of those sub-namespaces can be used as input in a limited set of scenarios (see table below).

Supported Namespaces

NamespaceDescriptionContent identifiedID examplesCase sensitive?Found inUsable in
musicPrimary namespace to identify all Xbox Music content across all Music APIs.Music artists, albums, tracksmusic.A83EB907-0100-11DB-89CA-0019B92A3933, music.AQQfoAnP2FoMuUGhob9VNyDIRAe5PqgAAQyesthe ID property of all pieces of music content returned by content APIsall APIs that accept a music ID or just a namespace as input
music.playlistSub-namespace to identify Xbox Music playlistsMusic playlistsmusic.playlist.ef30cdb7-2ad1-404b-9478-8fdc89ad35f0nothe ID property of all music playlists returned by content APIsall APIs that accept a music playlist ID as input (lookup, sub-browse, playlist edit, and so on)
music.amgSub-namespace that references music content via its public AMG identifierMusic tracks, albums, artistsmusic.amg.T 29381286nothe property OtherIds of Xbox Music pieces of content which have an associated AMG IDnone of our APIs
music.isrcSub-namespace that references music content via its public ISRC identifierMusic albums, tracksmusic.isrc.GBDJQ8800006nothe property OtherIds of Xbox Music pieces of content which have an associated ISRC ID, and only when accessed through the Lookup API on the Catalog sourcethe Lookup API when the source is Catalog
music.icpnSub-namespace that references music content via its public ICPN identifierMusic albums, tracksmusic.icpn.886443927087nothe property OtherIds of Xbox Music pieces of content which have an associated ICPN ID, and only when accessed through the Lookup API on the Catalog sourcethe Lookup API when the source is Catalog

Community Additions

ADD
Show:
© 2014 Microsoft