Don’t know the album UUID? Use the Get album by UPC or Get album by platform ID endpoints.
Get audience
Get the value of streams/fans for a specific album.
This endpoint returns the platform ID along with the audience count.
Available platforms and associated values are described below:
| Platform | Value |
|---|---|
| Spotify | Streams |
| Deezer | Fans |
Request
GET /api/v2/album/{uuid}/audience/{platform}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Album UUID |
Required |
| platform | string | A platform code |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| startDate | string | Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days |
|
| endDate | string | Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days |
|
| identifier | string | Optional album identifier (example : 2Fxmhks0bxGSBdJ92vM42m) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A album response with platform stream for a period |
Album Plot Collection |
| 400 | Bad Request
Invalid platform code |
|
| 401 | Unauthorized
You are not logged in |
|
| 403 | Forbidden
This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access. |
|
| 404 | Not Found
Album not found |