playlists

GET /playlists/trending/{version}

Returns trending playlists for a time period based on the given trending version

Request

Base URL
https://api.audius.co/v1
Auth
- none
- or OAuth 2
  Authorization code/v1/oauth/authorize
  Token URL/v1/oauth/token
  Scopesread
TypeScript
https://skmtc.dev/audius/apis/audius-api/docs/playlists/trending/:version/get.ts
A function with typed inputs. Its response is checked against the schema.

versionstring required

The strategy version of trending to use

offsetinteger

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

limitinteger

The number of items to fetch

user_idstring

The user ID of the user making the request

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

Calculate trending over a specified time range

Success

latest_chain_blockinteger required

latest_indexed_blockinteger required

latest_chain_slot_playsinteger required

latest_indexed_slot_playsinteger required

signaturestring required

timestampstring required

Nov 11, 2026ef0d432415e6 Revision changes
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
Sep 1, 2026940230b2ed3d Revision changes
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status