latestOpenAPI 3.1.02026-08-10202033.2 KB

d8deec5eca44

Get Time Of Day Recommendations

Get track recommendations suitable for a specific time of day.

Parameters:

<b>params</b> : TimeOfDayParams<br> - time: str (One of: morning, afternoon, evening, night)<br> - genre: str, optional (Specific genre filter)<br> - limit: int, default=20 (Number of recommendations)<br> <b>x_api_key</b> : str (API key for authentication)<br>

Returns:

TrackIDList<br> List of recommended track IDs suitable for the time of day<br>

Notes:

Different times of day have different energy/mood profiles.

post/api/v1/recommendations/time-of-day

Headers

x-api-keystring

Request body

timestring required

Time of day: morning, afternoon, evening, night

genrestring nullable

Optional genre filter

limitinteger

Number of recommendations

Response

Successful Response

track_idsstring[] required