Get YouTube views by ID
Get the view count for each YouTube video (official, lyric video, etc.) for a specific song.
Get the listing of available YouTube IDs per track in the Get IDs endpoint.
Need to get the song UUID first? Use the Get song by ISRC or Get song by platform ID endpoints.
Request
GET /api/v2/song/{uuid}/youtube/views/video/{identifier}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| uuid | string | A Song UUID |
Required |
| identifier | string | A YouTube videoID. |
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 |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A song response with YouTube views by video id for a period |
Song 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
Song not found |