Get user audience
This endpoint is restricted to specific plans. Reach out if you have any questions.
Get the user’s TikTok ID and audience data (likes, followers, following).
Need to get the TikTok username? Use the Get music videos by user or the Get video endpoints.
Request
GET /api/v2.11/tiktok/user/{username}/audience
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| username | string | A user username |
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 user audience collection |
user 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
User not found |