Sign in
Playlists

Generate a playlist result set (song, index, or id)

Get a list of song JSON, indexes or id's based on some simple search criteria 'recent' will search for tracks played after 'Popular Threshold' days 'forgotten' will search for tracks played before 'Popular Threshold' days 'unplayed' added in 400002 for searching unplayed tracks

get/songs/playlist-generate

Query parameters

mode'recent' | 'forgotten' | 'unplayed' | 'random'
filterstring

LIKE match to song title

albumstring
artiststring
flag0 | 1
format'song' | 'index' | 'id'
offsetinteger

Return results starting from this index position

limitinteger

Maximum number of results to return

Response

Generated list

OR
string[] required

Returned by format=id: song ids only, with no envelope.

Changes

Changed in 8 of the 46 revisions of this API.310

  • 535feee32afb1See the full diff
    • ○

      added the required property oneOf[SongsResponse]/song/items/mood to the response with the 200 status

      response-required-property-added

  • b152883a37a31See the full diff
    • ○

      added the required property oneOf[SongsResponse]/song/items/bpm to the response with the 200 status

      response-required-property-added

  • 48f80d018de41See the full diff
    • ○

      added the required property oneOf[SongsResponse]/song/items/last_played to the response with the 200 status

      response-required-property-added

  • e8e6b266ea295See the full diff
    • ○

      api operation id playlistGenerateSongs was added

      api-operation-id-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • 2ff18e50dcc111See the full diff
    • ▲

      added SongsResponse subschema #2 to the response body oneOf list for the response status 200

      response-body-one-of-added

    • ○

      removed subschema #1 subschema #2 from the response body oneOf list for the response status 200

      response-body-one-of-removed

  • 0659933e86191See the full diff
    • ▲

      response body list-of-types was widened by adding types array to media type application/json of response 200

      response-body-list-of-types-widened

  • 9abb9bf6d3bf1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 7ed7a764efd91See the full diff
    • ○

      endpoint added

      endpoint-added