Get TikTok music links ranking for a date
This endpoint is restricted to specific plans. View pricing
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
/api/v2/chart/tiktok/music/weekly/ranking/{datetime}
Path parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| datetime | string | A ranking date (ATOM format) | Required |
Query string parameters
| Parameter | Value | Description | Additional |
|---|---|---|---|
| offset | integer | Get results starting from position | Optional |
| limit | integer | Number of results (max. 100) | Optional |
Response
| 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. |