AUaudius
users

GET /users/{id}/weekly-rotation

Changed on

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 week and rolls over Wednesday 00:00 UTC. Unlike suggested-follows, this returns results for users with no listening history.

Request

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

  • ef0d432415e6Revision changes
    • info

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

    • info

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

  • 940230b2ed3dRevision changes
    • info

      endpoint added