To get in touch with the team and become an API user, please fill out this form.
Soundcharts provides many endpoints to help you build your own application upon our data
Our API is :Soundcharts API needs special headers to authenticate requests.
x-app-id is used to retrieve your customer rights.Soundcharts API follows HTTP specifications regarding error handling, each method describe the available response code it returns
The response always contains an errors array at root level that can provide more detailed error messages :
{
"errors": [
{
"key": "string",
"code": 0,
"message": "string"
}
]
}
Single object response have the following form:
{
"type": "string"
"object": {
}
}
Collections responses contains an items array and a page object to help you navigating through paged results:
{
"items": [
],
"page": {
"offset": 0,
"total": 100,
"next": null,
"previous": null,
"limit": 100
},
}
When requesting a collection related to a specific entity (ie getting charts position for a song) a related object containing the basic entity information is present in the response :
{
"related": {
}
}
The sandbox environment is free & open to everyone
Endpoint is located at https://customer.api.soundcharts.com or accessible in the examples here.App ID : soundcharts
Api KEY : soundcharts
The production environment is reserved to our registered customers
Endpoint is located at https://customer.api.soundcharts.com, contact us to get your production credentials.
All our API plans are subject to monthly quotas.
Once your quota is consumed, new requests will failed with an explicit error message.
The response will also contain a x-quota-remaining header with the number of remaining requests.