search

kellnerd / harmony

Music Metadata Aggregator and MusicBrainz Importer
MIT License
53 stars 7 forks source link

Tidal: support video releases #26

Open phw opened 5 months ago

phw commented 5 months ago

Tidal also provides videos as separate entities. They come with title, cover image, duration, release date, ISRC copyright info. Seems to be well suited to be added as releases on their own.

Examples:

API provides the /videos/{id} endpoint, see https://developer.tidal.com/reference/web-api?spec=catalogue&ref=get-video .

Example response for https://tidal.com/browse/video/358461354

{
  "resource": {
    "artifactType": "video",
    "id": "358461354",
    "title": "My Boy Only Breaks His Favorite Toys (Lyric Video)",
    "image": [
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/1024x256.jpg",
        "width": 1024,
        "height": 256
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/1080x720.jpg",
        "width": 1080,
        "height": 720
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/160x107.jpg",
        "width": 160,
        "height": 107
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/160x160.jpg",
        "width": 160,
        "height": 160
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/320x214.jpg",
        "width": 320,
        "height": 214
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/320x320.jpg",
        "width": 320,
        "height": 320
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/480x480.jpg",
        "width": 480,
        "height": 480
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/640x428.jpg",
        "width": 640,
        "height": 428
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/750x500.jpg",
        "width": 750,
        "height": 500
      },
      {
        "url": "https://resources.tidal.com/images/931df7cf/57ce/47f8/9a6e/c7cea3e19287/750x750.jpg",
        "width": 750,
        "height": 750
      }
    ],
    "releaseDate": "2024-04-19",
    "artists": [
      {
        "id": "3557299",
        "name": "Taylor Swift",
        "picture": [
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/1024x256.jpg",
            "width": 1024,
            "height": 256
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/1080x720.jpg",
            "width": 1080,
            "height": 720
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/160x107.jpg",
            "width": 160,
            "height": 107
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/160x160.jpg",
            "width": 160,
            "height": 160
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/320x214.jpg",
            "width": 320,
            "height": 214
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/320x320.jpg",
            "width": 320,
            "height": 320
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/480x480.jpg",
            "width": 480,
            "height": 480
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/640x428.jpg",
            "width": 640,
            "height": 428
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/750x500.jpg",
            "width": 750,
            "height": 500
          },
          {
            "url": "https://resources.tidal.com/images/03a7ff5b/e309/4c66/9df7/d469d8049c3d/750x750.jpg",
            "width": 750,
            "height": 750
          }
        ],
        "main": true
      }
    ],
    "duration": 208,
    "trackNumber": 0,
    "volumeNumber": 0,
    "isrc": "USUMV2400558",
    "copyright": "© 2024 Taylor Swift",
    "properties": {},
    "tidalUrl": "https://tidal.com/browse/video/358461354"
  }
}