tracks

GET /tracks/recommended/{version}

Changed on

Get recommended tracks using the given trending strategy version

Request

Path parameters

versionstring required

The strategy version of trending to use

Query parameters

limitinteger

The number of items to fetch

genrestring

Filter trending to a specified genre

time'week' | 'month' | 'year' | 'allTime'

Calculate trending over a specified time range

exclusion_listinteger[]

List of track ids to exclude

user_idstring

The user ID of the user making the request

Response

Success

latest_chain_blockinteger required
latest_indexed_blockinteger required
latest_chain_slot_playsinteger required
latest_indexed_slot_playsinteger required
signaturestring required
timestampstring required

Example response

{
  "data": [
    {
      "stream_conditions": {
        "usdc_purchase": {
          "splits": [
            {
              "user_id": 1234
            }
          ]
        }
      },
      "download_conditions": {
        "usdc_purchase": {
          "splits": [
            {
              "user_id": 1234
            }
          ]
        }
      }
    }
  ]
}

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status