Skip to main content
GET
/
v1
/
listening
/
genres
Genre breakdown
curl --request GET \
  --url https://api.rewind.rest/v1/listening/genres \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "period": "2026-01",
      "genres": {
        "Rock": 245,
        "Hip-Hop": 112,
        "Electronic": 87,
        "Other": 89
      },
      "total": 533
    },
    {
      "period": "2026-02",
      "genres": {
        "Pop": 180,
        "Rock": 150,
        "Hip-Hop": 95,
        "Other": 76
      },
      "total": 501
    },
    {
      "period": "2026-03",
      "genres": {
        "Grunge": 120,
        "Rock": 110,
        "Pop": 90,
        "Other": 67
      },
      "total": 387
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

​
date
string

Single day (YYYY-MM-DD). Overrides from/to.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2025-02-17"

​
from
string

Range start, inclusive (ISO 8601)

Example:

"2025-02-01T00:00:00Z"

​
to
string

Range end, inclusive (ISO 8601)

Example:

"2025-02-28T23:59:59Z"

​
group_by
enum<string>
default:month
Available options:
week,
month,
year
Example:

"month"

​
limit
integer
default:10

Max genres to return (rest grouped as "Other")

Required range: 1 <= x <= 50
Example:

10

​
compare_to
enum<string>

When set to previous_year, returns a compare array with the same shape as data but for the window shifted back one year. Requires from + to or date to be set; ignored otherwise.

Available options:
previous_year
Example:

"previous_year"

Response

Genre breakdown by period

​
data
object[]
required
​
compare
object[]