第三方數據串接

初探音樂數據第三方平台: SoundCharts

Ivan Cheng

03 Sep 2025 • 3 min read

SoundCharts 平台是一個豐富的音樂資料庫，使用者除了可以從平台介面查詢，對於進階用戶，SoundCharts 也提供豐富的 API 做串接 (See: Getting Started)。本文會簡單介紹一個例子，給讀者感受一下。

取得 Spotify歌曲 ID (trackID)

第一步驟是先取得歌曲在 Spotify 上對應的ID，又稱為 trackID。

複製連結後，會得如下的值：

https://open.spotify.com/track/5jzg774Qb6yM7Khqe5euvc?si=01880e15a9484ccc

其中 5jzg774Qb6yM7Khqe5euvc 就是trackID。

查詢歌曲對應 SoundCharts uuid

為了跟不同的平台做解耦，SoundChart API 實際查詢時會使用它們自己的 uuid ，而不是各個平台自己的 id。

為此，SoundCharts 提供了 Get song by platform ID，可以讓用戶輸入不同平台上的 ID，查詢對應在 SoundCharts 平台上的 uuid。

Response

{
  "type": "song",
  "object": {
    "uuid": "b0e7bb4c-e240-4049-8606-94ea72493772", // SoundChart's Track ID
    "name": "怪天氣",
    "isrc": {
      "value": "TWFM52002001",
      "countryCode": "TW",
      "countryName": "Taiwan"
    },
    "creditName": "YELLOW黃宣 & 9m88",
    "artists": [
      {
        "uuid": "ecc17a50-c7e8-11e8-9cf9-549f35161576",
        "slug": "9m88",
        "name": "9m88",
        "appUrl": "https://app.soundcharts.com/app/artist/9m88/overview",
        "imageUrl": "https://assets.soundcharts.com/artist/8/e/7/ecc17a50-c7e8-11e8-9cf9-549f35161576.jpg"
      },
      {
        "uuid": "c0a86f36-e503-11e8-b973-549f35161576",
        "slug": "yellow-11",
        "name": "YELLOW",
        "appUrl": "https://app.soundcharts.com/app/artist/yellow-11/overview",
        "imageUrl": "https://assets.soundcharts.com/artist/3/0/5/c0a86f36-e503-11e8-b973-549f35161576.jpg"
      }
    ],
    "releaseDate": "2020-09-14T00:00:00+00:00",
    "copyright": "℗ 2020 WRONGTYPE Production Co., Ltd.",
    "appUrl": "https://app.soundcharts.com/app/song/b0e7bb4c-e240-4049-8606-94ea72493772/overview",
    "imageUrl": "https://assets.soundcharts.com/song/0/4/2/b0e7bb4c-e240-4049-8606-94ea72493772.jpg",
    "duration": 259,
    "explicit": false,
    "genres": [
      {
        "root": "pop",
        "sub": [
          "pop"
        ]
      },
      {
        "root": "r&b, funk & soul",
        "sub": [
          "r&b, funk & soul"
        ]
      }
    ],
    "composers": [
      "9m88",
      "YELLOW黃宣"
    ],
    "producers": [],
    "labels": [
      {
        "name": "WRONGTYPE Production",
        "type": "unknown"
      }
    ],
    "audio": {
      "acousticness": 0.8,
      "danceability": 0.59,
      "energy": 0.38,
      "instrumentalness": 0,
      "key": 6,
      "liveness": 0.13,
      "loudness": -14.76,
      "mode": 0,
      "speechiness": 0.36,
      "tempo": 77.55,
      "timeSignature": 4,
      "valence": 0.47
    },
    "languageCode": "zh-Hans",
    "distributor": ""
  },
  "errors": []
}

取得歌曲播放量

得到歌曲的 uuid 後，就可以開始使用平台上各個不同的 API 接口。

例如想查詢歌曲在 Spotify的播放量，就可以用 Get audience 獲取數據。

Response

{
  "related": {
    "uuid": "b0e7bb4c-e240-4049-8606-94ea72493772",
    "name": "怪天氣",
    "creditName": "YELLOW黃宣 & 9m88",
    "imageUrl": "https://assets.soundcharts.com/song/0/4/2/b0e7bb4c-e240-4049-8606-94ea72493772.jpg"
  },
  "items": [
    {
      "date": "2025-09-02T00:00:00+00:00",
      "plots": [
        {
          "identifier": "5jzg774Qb6yM7Khqe5euvc",
          "value": 12124306 // 播放量
        }
      ]
    },
    {
      "date": "2025-09-01T00:00:00+00:00",
      "plots": [
        {
          "identifier": "5jzg774Qb6yM7Khqe5euvc",
          "value": 12119367
        }
      ]
    },
    {
      "date": "2025-08-31T00:00:00+00:00",
      "plots": [
        {
          "identifier": "5jzg774Qb6yM7Khqe5euvc",
          "value": 12114308
        }
      ]
    }
  ],
  "page": {
    "offset": 0,
    "limit": 100,
    "next": null,
    "previous": null,
    "total": 4
  },
  "errors": []
}

潛在問題

數據覆蓋率：不一定每首歌曲都能馬上找到對應的 Soundcharts uuid，可能會有收錄時間延遲或其他缺失原因，導致查無歌曲
數據延遲：透過 API 回傳的最新播放量是 12,124,306，但實際看 Spotify 是 12,129,300，數據存在一些延遲

參考資料