Get audience report for a date
Get the latest demographics reports for social/streaming platforms.
To avoid unnecessary requests, you can first get the dates with available data from the Get available audience report dates endpoint.
Available platforms for this endpoint are Instagram, YouTube, and TikTok. Note that the depth for these platform reports depends on the platform. Instagram is the only platform that returns data for both likes & followers.
Find out some definitions of terms found in these reports in the Get audience report - latest endpoint.
Don't know the artist UUID yet? Use the Get artist by platform ID or Search artist by name endpoints.
Note: Audience reports are updated monthly.
Request
GET /api/v2/artist/{uuid}/audience/{platform}/report/{date}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | An artist UUID |
Required |
| platform | string | A social platform code |
Required |
| date | string | A report date (YYYY-MM-DD) |
Required |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
An Artist audience report response |
Audience Report |
| 400 | Bad Request
Invalid request |
|
| 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
Artist not found |