users

Gets the user's Weekly Rotation mix - a personalized set of tracks they have not heard, weighted toward artists they do not already follow. The mix is fixed for the calendar week (ISO week, UTC) and rotates when the week rolls over. Unlike suggested-follows, this returns results for users with no listening history.

get/users/{id}/weekly-rotation

Path parameters

idstring required

A User ID

Query parameters

limitinteger

The number of tracks to fetch (default 30, max 50)

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

No recorded changes to this endpoint across all 1 revision of this API.