Skip to main content
GET
Genre breakdown

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[]