FAQ
1. Get started with the API
- How to use the Music Story Pro API ?
You will find a complete documentation on the use of our API in the documentation section of the website. A testing tool is at your disposal allowing you to directly make your request by choosing its settings and to test the response. Warning : it can only be used once you are connected.
- How to start developing ?
As soon as you submit your subscription, you will receive a confirmation email. After having confirmed, you will receive two API keys that will give you an immediate access to the API. Please read the terms of use thoroughly before any use. You will be able to find in your personal space : information linked to our type of account, your statistics as well as your API keys.
- Why do I need API keys ?
These are strictly personal keys that allow you to identify yourself in order to open an API user session. We provide you with two keys : the consumer key and the consumer secret key.
- What to do if I have problems with the API ?
As soon as you subscribe, you will benefit from a basic assistance via e-mail or our forum. You will then be able to benefit from a quicker and dedicated support. We refer you to our offer description.
2. Terms of use
- What is a commercial or a non commercial-use ?
The commercial use is carried out by a private or public company when it publishes an application using the API and the metadata. A blogger or even an association can have a non-commercial use. For more information, consult the terms of use.
- Can I freely publish any content from the API?
In the case of a non-commercial use, a limited number of editorial data coming from Music Story can be published joined by a link and a Music Story logo. For more information, please consult the terms of use.
If you use the data of a partner's platform, we advise you to read the terms of use of the partner concerned before any data operation.
- What are my responsibilities as a user ?
You have the responsibility for your own identity, also you must not give out either your ID or your API keys. You have to use the API within the law and respect the licences provided with the concerned data. For more details, we refer you to our terms of use.
3. API response
4. Quotas & restrictions
- How to know my number of remaining queries ?
Log in and visit your personnal space, you have a live access to all the API statistics concerning you.
- What is an item ?
An item is an editorial data subject to broadcasting rights. There are biographies, album previews, news, some data (an artist's real name for example) and part of the pictures which are produced or acquired by Music Story.
- I have exceeded the limits of my subscription, what to do ?
The limits are reset the 1st of every month. You have to either wait for the next month or apply to another subscription which will allow you to extend your possibilities.
- The API's response time seems too long, what is the reason ?
The API limits the number of requests by second for a user. If however, you consider that the response delay overextends this restriction, please contact the assistance desk.
- Am I banned ?
If you have reasons to believe that you have been blacklisted, stop all of your current requests and contact the assistance desk in order to know more about the reasons, if you have actually been banned. In order to avoid it happening again, please take in consideration the terms of use in order to enjoy our services.
5. Music Story Pro metadata
- What is the difference between album and release ?
A release refers to a product identified by its EAN, in digital or physical format, which corresponds to an edition of an album. An album is a coherent gathering of several editions matching the general public's understanding of what is an album.
For example : Daft Punk's album Random Access Memories gathers every corresponding releases (EAN products).
- What is the difference between a track, a recording and a work ?
A track is an element of the list of tracks from a release. A recording is a file identified by an ISRC code and it can correspond to several tracks. A work is identified by its ISWC (or COCV) or in the sense of edition rights. A work often leads to several recordings (different interpretations, re-recordings...)
- Can the Music Story API be substituted for its partners' or the social networks' API
No. The API doesn't issue partner metadata, nor data belonging to social networks. It provides an efficient means of linking artists, album edition, Music Story tracks to their equivalent on another platform, or between platforms, which allows you then to use other APIs at your disposal.
- May I have access to all metadata ?
Yes. However, depending on your type of account, you can be limited in the number of requests, or in the number of items, depending on the type of data. These limitations, and your requests or available subjects are displayed in your personnal space. In order to enjoy a less restricted access, please refer to our offer descritption.
- Are there other features I should know about ?
None, the API Music Story is easily accessible and intuitive. The complete documentation is here to help you.
6. Some tools
