getSonicSimilarTracks

Returns similar tracks based on sonic (audio) analysis.

Opensubsonic:

Addition

http://your-server/rest/getSonicSimilarTracks

Returns tracks that are sonically similar to a given track, based on audio analysis. Each result includes its normalized distance from the query track.

Parameters

Parameter	Req.	OpenS.	Default	Comment
`id`	Yes			The ID of the song.
`count`	No		10	Max number of similar tracks to return.

Example

http://your-server/rest/getSonicSimilarTracks.view?id=100&count=5&u=demo&p=demo&v=1.13.0&c=AwesomeClientName&f=json

Result

A subsonic-response element with a top-level sonicMatch array on success.

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true,
    "sonicMatch": [
        {
          "entry": {
            "id": "300000060",
            "parent": "200000002",
            "title": "BrownSmoke",
            "isDir": false,
            "isVideo": false,
            "type": "music",
            "albumId": "200000002",
            "album": "Colorsmoke EP",
            "artistId": "100000002",
            "artist": "Synthetic",
            "coverArt": "300000060",
            "duration": 304,
            "bitRate": 20,
            "bitDepth": 16,
            "samplingRate": 44100,
            "channelCount": 2,
            "track": 4,
            "year": 2007,
            "genre": "Electronic",
            "size": 792375,
            "discNumber": 1,
            "suffix": "wma",
            "contentType": "audio/x-ms-wma",
            "path": "Synthetic/Synthetic_-_Colorsmoke_EP/04-Synthetic_-_BrownSmoke.wma"
          },
          "similarity": 0.05
        },
        {
          "entry": {
            "id": "300000055",
            "parent": "200000002",
            "title": "Red&GreenSmoke",
            "isDir": false,
            "isVideo": false,
            "type": "music",
            "albumId": "200000002",
            "album": "Colorsmoke EP",
            "artistId": "100000002",
            "artist": "Synthetic",
            "coverArt": "300000055",
            "duration": 400,
            "bitRate": 64,
            "bitDepth": 16,
            "samplingRate": 44100,
            "channelCount": 2,
            "track": 5,
            "year": 2007,
            "genre": "Electronic",
            "size": 3209886,
            "discNumber": 1,
            "suffix": "mp3",
            "contentType": "audio/mpeg",
            "path": "Synthetic/Synthetic_-_Colorsmoke_EP/05-Synthetic_-_RedGreenSmoke.mp3"
          },
          "similarity": 0.12
        }
      ]
    }
  }
}

Does not exist.

Field	Type	Req.	OpenS.	Details
`sonicMatch`	Array of `sonicMatch`	Yes		The similar tracks with per-track similarity

Last modified March 26, 2026: changed sonicMath structure to match bokmark (5da332c)