Get video audience
This endpoint is restricted to specific plans. Reach out if you have any questions.
Get the video’s historical audience data (comments/likes/plays/shares) and the user’s ID/username and follower count.
Need to get the TikTok video ID? Use the Get music videos by user or the Get user video endpoints.
Request
GET /api/v2/tiktok/video/{identifier}/audience
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| identifier | string | A video identifier |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| endDate | string | Optional period filter (YYYY-MM-DD format) |
|
| period | integer | Number of historical days (max. 90) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A video audience collection |
Video audience collection |
| 400 | Bad Request
Invalid period |
|
| 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
Video not found |