Get short video audience
Get the short video’s historical audience data (comments/likes/views).
This endpoint is available for YouTube shorts, Instagram reels and TikTok videos.
The refresh frequency for Instagram and YouTube short videos depends on the artist’s follower count on each platform:
- less than 9 followers: every 15 days
- between 10 and 149 followers: every 7 days
- between 150 and 499 followers: every 5 days
- between 500 and 4,999 followers: every 3 days
- more than 5,000: every 2 days
TikTok short video data is updated monthly.
Need to get the short video ID? Use the Get short videos endpoint.
Request
GET /api/v2/artist/shorts/{identifier}/audience
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| identifier | string | A short/reel/video identifier |
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 Short video Audience collection response |
ShortVideo Audience Collection |
| 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
Short Video not found |