---
title: "Changes to Get TikTok music links ranking for a date (premium)"
method: GET
path: "/api/v2/chart/tiktok/music/weekly/ranking/{datetime}"
---

# Changes to Get TikTok music links ranking for a date (premium)

`GET /api/v2/chart/tiktok/music/weekly/ranking/{datetime}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 8 revisions.

- **2026-11-10** `0d77a777541f`: 14 breaking, 26 info
- **2026-11-10** `001f23a14a51`: 1 breaking, 40 info

## Changes

- **2026-11-10** `0d77a777541f`: 14 breaking, 26 info
  - the response property `errors` became optional for the status `200`
  - the response property `items` became optional for the status `200`
  - the response property `items/items/entryState` became optional for the status `200`
  - the response property `items/items/music` became optional for the status `200`
  - the response property `items/items/rankDate` became optional for the status `200`
  - the response property `items/items/song` became optional for the status `200`
  - the response property `page` became optional for the status `200`
  - the response property `page/limit` became optional for the status `200`
  - the response property `page/next` became optional for the status `200`
  - the response property `page/offset` became optional for the status `200`
  - the response property `page/previous` became optional for the status `200`
  - the response property `related` became optional for the status `200`
  - the response property `related/chart` became optional for the status `200`
  - the response property `related/date` became optional for the status `200`
  - api operation id `get_charts_tiktok_music_ranking_2.0` removed and replaced with ``
  - the `authorName` response's property default value `` was removed for the status `200`
  - the `code` response's property default value `0` was removed for the status `200`
  - the `creditName` response's property default value `` was removed for the status `200`
  - the `frequency` response's property default value `` was removed for the status `200`
  - the `identifier` response's property default value `` was removed for the status `200`
  - the `imageUrl` response's property default value `` was removed for the status `200`
  - the `imgUrl` response's property default value `` was removed for the status `200`
  - the `key` response's property default value `` was removed for the status `200`
  - the `message` response's property default value `` was removed for the status `200`
  - the `name` response's property default value `` was removed for the status `200`
  - the `oldPosition` response's property default value `0` was removed for the status `200`
  - the `oldTotalValue` response's property default value `0` was removed for the status `200`
  - the `oldValue` response's property default value `0` was removed for the status `200`
  - the `peakPosition` response's property default value `0` was removed for the status `200`
  - the `position` response's property default value `0` was removed for the status `200`
  - the `positionEvolution` response's property default value `0` was removed for the status `200`
  - the `timeOnChart` response's property default value `0` was removed for the status `200`
  - the `timeOnChartUnit` response's property default value `DOC` was removed for the status `200`
  - the `title` response's property default value `` was removed for the status `200`
  - the `total` response's property default value `0` was removed for the status `200`
  - the `totalValue` response's property default value `0` was removed for the status `200`
  - the `type` response's property default value `music` was removed for the status `200`
  - the `url` response's property default value `` was removed for the status `200`
  - the `uuid` response's property default value `` was removed for the status `200`
  - the `value` response's property default value `0` was removed for the status `200`
- **2026-11-10** `001f23a14a51`: 1 breaking, 40 info
  - the response property `items/items/entryDate` became nullable for the status `200`
  - api operation id `get_charts_tiktok_music_ranking_2.0` was added
  - the response property `errors` became required for the status `200`
  - the response property `items` became required for the status `200`
  - the response property `items/items/entryState` became required for the status `200`
  - the response property `items/items/music` became required for the status `200`
  - the response property `items/items/rankDate` became required for the status `200`
  - the response property `items/items/song` became required for the status `200`
  - the response property `page` became required for the status `200`
  - the response property `page/limit` became required for the status `200`
  - the response property `page/next` became required for the status `200`
  - the response property `page/offset` became required for the status `200`
  - the response property `page/previous` became required for the status `200`
  - the response property `related` became required for the status `200`
  - the response property `related/chart` became required for the status `200`
  - the response property `related/date` became required for the status `200`
  - the `authorName` response's property default value `` was added for the status `200`
  - the `code` response's property default value `0` was added for the status `200`
  - the `creditName` response's property default value `` was added for the status `200`
  - the `frequency` response's property default value `` was added for the status `200`
  - the `identifier` response's property default value `` was added for the status `200`
  - the `imageUrl` response's property default value `` was added for the status `200`
  - the `imgUrl` response's property default value `` was added for the status `200`
  - the `key` response's property default value `` was added for the status `200`
  - the `message` response's property default value `` was added for the status `200`
  - the `name` response's property default value `` was added for the status `200`
  - the `oldPosition` response's property default value `0` was added for the status `200`
  - the `oldTotalValue` response's property default value `0` was added for the status `200`
  - the `oldValue` response's property default value `0` was added for the status `200`
  - the `peakPosition` response's property default value `0` was added for the status `200`
  - the `position` response's property default value `0` was added for the status `200`
  - the `positionEvolution` response's property default value `0` was added for the status `200`
  - the `timeOnChart` response's property default value `0` was added for the status `200`
  - the `timeOnChartUnit` response's property default value `DOC` was added for the status `200`
  - the `title` response's property default value `` was added for the status `200`
  - the `total` response's property default value `0` was added for the status `200`
  - the `totalValue` response's property default value `0` was added for the status `200`
  - the `type` response's property default value `music` was added for the status `200`
  - the `url` response's property default value `` was added for the status `200`
  - the `uuid` response's property default value `` was added for the status `200`
  - …1 more

---

[Operation](https://skmtc.dev/soundcharts/apis/soundcharts-api/docs/api/v2/chart/tiktok/music/weekly/ranking/:datetime/get.md) - [API](https://skmtc.dev/soundcharts/apis/soundcharts-api.md) - [Page](https://skmtc.dev/soundcharts/apis/soundcharts-api/changes/api/v2/chart/tiktok/music/weekly/ranking/:datetime/get)
