users

Get For You feed for user

Returns a personalized For You feed for the user identified in the path. The response is a heterogenous list of tracks and playlists/albums ({type, timestamp, item} envelope), mirroring the chronological /v1/users/{id}/feed shape so clients can render both in a single ranked list. Twitter-style multi-source pipeline — candidate retrieval (in-network, trending, underground) → linear ranking (recency decay × engagement × social affinity, weighted by source) → diversity (shared per-artist cap across tracks + collections + consecutive-same-artist lookahead).

get/users/{id}/feed/for-you

Path parameters

idstring required

A User ID

Query parameters

limitinteger

The number of items to fetch

offsetinteger

The number of items to skip. Useful for pagination (page number * limit)

max_per_artistinteger

Maximum number of items (tracks or playlists/albums combined) per artist on a single page. Used by the diversity pass to cap consecutive same-artist results.

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

Changes

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