Get TikTok music links ranking for a date
This endpoint is restricted to specific plans. Reach out if you have any questions.
Get the ranking of trending TikTok music links for a specific date.
To avoid unnecessary requests, you can first get the dates with available data from the Get TikTok music links ranking dates endpoint.
We track millions of TikTok music links, so the response might have many pages.
The metric used to create this chart is the number of videos using this sound that were created in the past 7 days.
This endpoint also returns the number of days (DOC) or weeks (WOC) that a song has been on that chart.
Request
GET /api/v2/chart/tiktok/music/weekly/ranking/{datetime}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| datetime | string | A ranking date (ATOM format) |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| offset | integer | Get results starting from position |
|
| limit | integer | Number of results (max. 100) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A TikTok Rank Collection response |
TiktokMusicRankCollectionResponse |
| 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. |