This section introduces Nokia's Music APIs, outlines the key benefits of using the APIs and describes the use cases for which they were designed.
What are the Music APIs?
Nokia's Music APIs (or “Music APIs”, for short) are a collection of web service and Windows Phone APIs that allow you to offer elements from Nokia's Music service (as available in Nokia Music for Lumia) within the look & feel of your own application.
The Music service supports a variety of use cases that center around two major features:
- Music discovery – Help users find the music relevant to them
- Music information retrieval – Provide detailed information about music users are interested in
For music discovery, the Music APIs support two different usage scenarios that you may select according to the requirements for your application:
- search – find music that matches search terms provided by the user
- explore – guide users to discover music through charts and recommendations
The core of the Music APIs is our catalog of available Music. As with all music services, we license content from record labels per country and therefore availability varies. We also work to localise our catalogue with the most relevant content for each country. As the Music APIs require a country code to filter the availability, we offer a method to help validate the country your users originate from.
Why Use the Music APIs?
The Music APIs provide a simple, future-proof way to grant your application's users access to the latest information about millions of tracks from all over the globe.
By using the Music APIs, your application gains several crucial advantages, including:
- Reduced application complexity
- Forward-compatible API contracts
When you use the Music APIs to build an application, your users can find music from
- over 200 countries
- over 3 million global and local artists
- over 20 million tracks (that's around 134 years of continuous listening!)
- over a century of recordings
Reduced Application Complexity
Collecting and — even more important — maintaining facts about tens of millions of tracks from record labels and aggregators is a challenging task. Without the Music APIs, you would have to spend an enormous amount of your resources just to collect, validate, standardize and maintain this data.
Unless your core business is being a local search engine, it is quite unlikely that you want to invest in that area.
Forward-Compatible API Contract
The API contract of the Music REST API has been carefully crafted to deal with the fact that there is always more to know about music.
The API contract is designed in a way that allows us to introduce additional elements at any time, without being forced to introduce a new version of the API contract. But even more important: When you follow the guidance and best practices described in this document, you application user's will also automatically receive access to those new features without you being forced to build and ship a new version of your application.
For more information, see Key Concepts.
Artist Location Data