Microsoft Groove Music

Microsoft Groove Music Logo
Microsoft Groove Music Free
Microsoft Groove Music Android

-->

Jun 24, 2021 A surprising hidden gem in Windows 10 that few people talk about is Groove Music. While it used to be a music player and digital music subscription service/store all in one, now it’s just a music player. If you’ve never taken the app for a test drive, you’re probably not alone. Groove Music is Microsoft's answer to iTunes and comes included with Windows 10. It offers a way for you to build and access your music collection, and, as with any good music player, it allows. 8/10 (198 votes) - Download Groove Music Free. Groove Music is Microsoft's music streaming service. It comes with a catalog with over 40 million songs and allows you to upload your own to OneDrive. Nowadays we're fully aware of who the leaders of the music streaming industry are.

Browse the music catalog.

Remarks

The Browse Catalog request is composed of mandatory and optional URL parts and query parameters. A request containing all parameters would resemble the following string:

Note
Pagination is zero-based (the first page is found at page 0), and catalog browse will not return more than 1000 total items.
You cannot combine the following filters together in the same request: genre, mood, activity.

For parameters common to every Groove RESTful API, see Parameters common to every Groove RESTful API. For a table of error codes, see Error (JSON). For HTTP status codes, see Groove RESTful API HTTP Status Codes.

Response object

Query string parameters

The following parameters are not available on the Common Parameters page.

Parameter	Type	Description
namespace	string	The namespace to browse.
type	string	Required. The type of item to browse. The following values are supported: 'albums', 'artists', 'tracks'.
orderBy	string	Optional. Ordering chosen for that content (orderBy field). If incompatible, an HTTP 400 error will be emitted.
genre	string	Optional. Genre name; filters browsing to return only items in a specific genre of content. Possible values can be obtained using the browse genres API, and must be properly URL-encoded.
mood	string	Optional. Mood name; filters browsing to return only playlists in a specific mood category. Possible values can be obtained using the browse moods API, and must be properly URL-encoded.
activity	string	Optional. Activity name; filters browsing to return only playlists in a specific activity category. Possible values can be obtained using the browse activities API, and must be properly URL-encoded.
maxItems	32-bit signed integer	Optional. The number of items to browse per page. The default value is 25, and it's the maximum value allowed as well.
page	32-bit signed integer	Optional. The page to browse (will skip page*maxItems items). The first (and default) page is page 0.
continuationToken	string	A continuation token provided in an earlier service response and optionally passed back to the service to request the continuation of an incomplete list of content.
extra	string	Required. The type of the requested sub-elements (for example, 'Tracks' or 'Albums'). See Extras.

Examples

Browse the most popular catalog artists in your region

Request

Response

Browse the playlists in the 'Sleepy' mood category

Request

Response

Browse the 5 most played albums in your region

Request

Response

Browse the 50 most played tracks in France

Request

Response

Continuation Request (using 'page=1', but it could also have used the ContinuationToken from the first response instead)

Response

Parent

-->

| Notice to customers||----- ||Starting Oct 2nd, the onboarding to the Groove Music API is disabled. As part of the partnership, the Groove Music Pass service will be discontinued on December 31, 2017. After that date, Groove Music Pass content will not stream or play and our API features will not be accessible.Please check our FAQ on https://aka.ms/groovepartnerfaq . All features of the Music API will be supported until Dec 31st.|

Developer authentication is mandatory for all functions in the Groove API. All the functions share a common mandatory query parameter, accessToken, in which a valid authentication token must be passed.

Authentication token

###Nota BeneThere are two distinct use cases depending on the API you are using. If your API calls are user authenticated, follow instructions onGroove User Authentication. For authenticated calls, you need only include the User Authentication token to your request.

For unauthenticated API

The authentication token is based on the Simple Web Token (SWT) format. It contains a list of name-value claims that identify the client application and validity period of the token; it also contains a signature to prevent malicious users from modifying the contents of the token. For more information about SWT, see Simple Web Token on MSDN.

This authentication token is obtained from the Live authentication endpoint, and it should be considered opaque and be passed as-is in requests to the Groove Service; the only change necessary is to prefix the token with 'Bearer', a standard prefix for OAuth tokens.

The tokens have a validity period of 24 hours, and there is a mechanism for renewing tokens described in Renewing the token before it expires, later in this topic.

Using valid tokens

In order to be able to use the Groove Music API, a third-party developer must first create a developer account on Microsoft Developer Center and then sign up to the Groove Music API program (for free).

Once properly subscribed, the third-party app should obtain authentication tokens from the Live service by using the procedure in this section; the scope to use is app.music.xboxlive.com . The tokens have a validity
period of 24 hours and must be renewed after they expire—or ideally, before they expire.

You must obtain an access token to use the Groove Music API. The access token is passed with each API call and is used to authenticate your access to the Groove Music API. It provides a secure access to the Groove Music API and allows the API to associate your application's requests to the Groove Service with your account on the Developer Center.

Microsoft provides methods to obtain access tokens safely, repeatedly, and easily. To obtain an access token, complete the steps in the following procedure; each step links to a subsection in this topic that describes the step in more detail.

Create a developer account on Microsoft Developer Center

Subscribe to the Groove Music API on Microsoft Developer Center. Subscriptions are free.

To subscribe to the Groove Music API

Visit https://developer.microsoft.com/groove.
Click Sign In in the upper right corner.
Register with the Microsoft account of your choice.
If you don't have a Microsoft Account, you'll need to create a new one.
On https://developer.microsoft.com/groove, click the Sign up link or visit https://developer.microsoft.com/dashboard/groove.
Fill in the correct details about you carefully - we'll need your valid email address to contact you.
Read the Terms Of Use and accept them. Then click on Subscribe to Groove Music API Program.

You are now a member of the Groove Music API Program!

You will now need to associate Applications to your account.

## Register your application for the Groove Music API.After subscribing to the Groove Music API, you must associate your application to your program.

Create an application

To register your app to connect with Groove, you'll need a Microsoft account.

Go to the Microsoft Application Registration Portal
When prompted, sign in with your Microsoft account credentials.
Find My applications and click Add an app.
Enter your app's name and click Create application.
Scroll to the bottom of the page and check the Live SDK support box.

After you've completed these steps, an application ID and application secret are created for your app and displayed on your new app's properties page.

Important Treat the value of client secret the same as you would a user's password. The secret represents the key to your application and, if made available, can be used to impersonate your application.

Under the Platforms header, configure details about your app. By default a new app is created as a web app and needs one or more redirect URIs. To enable native client flows for your app as well, click the Add Platform button and choose Mobile.

Allow this application to access Groove Music API

When signed-in to the developer center, on https://developer.microsoft.com/groove, click the Sign up link or visit https://developer.microsoft.com/dashboard/groove.
Follow the instructions on the page. You'll need to obtain an authentication token see also below
Enter the obtained authentication token in the field and click on Register. (ie: EgBtAQMAAAAEgA9BCG...c1Ni05YTNwA=)
You can register up to 16 apps. You can manage them on this page.

## Make an HTTP POST request to the token service In order to register your application or afterwards to call our unauthenticated API, make a POST request to the token service to obtain the access token. The parameters for the token request are URL-encoded and passed in the HTTP request body. Table 1 lists the mandatory input parameters and their descriptions.

Table 1. Token request input parameters

Parameter name	Value	Description
grant_type	string	Use 'client_credentials' as value for application token authentication.
client_id	string	Your Application ID as displayed on your application page on the Microsoft Application Registration Portal
client_secret	string	Your Application Secret as displayed on your application page on the Microsoft Application Registration Portal. The value needs to be URL encoded.
scope	string	The scope your application requires. For application access to the Groove API the scope is 'app.music.xboxlive.com'

The response for the token request contains the access token that you can use to access the Groove Music API. The response is JSON-encoded and includes the output properties shown in Table 2.

Table 2. Token request output properties

Property	Description
accessToken	The access token that you can use to authenticate you access to the Groove Music API.
token_type	The type of the token.
expires_in	The number of seconds for which the access token is valid.

Example

If the application id and secret values are correct, the service willreply with a JSON object containing the token type, the access token'svalue and an expiry delay.

The resulting application access token can then be used in applicationcalls using the OAuth 2.0 bearer authorization method.

Note that tokens expire. Applications should take token expiry intoaccount and reauthenticate before access token expiry.

Important: Treat the value of access_token in this response assecurely as you would a user's password.

## Using the access tokenAs mentioned earlier in this topic, you must obtain an access token to use the Groove Music API. To use authenticated API, please refer to the [dedicated page](user-authentication.md).The access token is secure, OAuth standard compliant, and flexible. The value of access token can be used for subsequent calls to the Groove Music API. The access token expires after 24 hours.

It is always better to check elapsed time between the time at which the token was issued and the current time. If the elapsed time exceeds 24 hours, renew the access token by following the procedure for obtaining the access token.

Remember the following points about using the access token:

Either pass the 24 hours token you obtain as the parameter accessToken, or use the value of the accessToken property as the Authorization header to the calls to the Groove Music API. In either case, use the prefix 'Bearer '.
The access token is valid for 24 hours. If the access token expires, you need to generate a new access token. The sample code in C#, linked at the end of this topic , can generate a new access token prior to exceeding the 24 hours period.

## Protecting the client's secret valueThe tokens are obtained from Azure Marketplace in exchange for a client ID and secret value, obtained during the subscription. If possible, these should be secured and used in such a way that cannot be intercepted on the client machine.

If the application has a server component, then the server should be responsible for storing the client ID and secret value, and the server should obtain the tokens on behalf of the client component so that the secret value cannot be intercepted on the client machines.

## Calling the Groove Music API with the tokenOnce it is in possession of a valid authentication token, a third-party application may call the Groove Music API and provide the OAuth token as the value of the **Authorization** HTTP header.