Collection
Get all genres
Endpoint URL
/api/genres
HTTP Method
GET
Authentication
Client ID required. See how to authenticate public resources here.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
| limit | optional | Specifies the maximum number of records to retrieve. You are guaranteed to get at most this number of results, but you may get fewer. If set to zero or less, returns nothing. Maximum value is 200 (i.e., if greater than 200, returns only 200). If not supplied, defaults to 20. | 20 |
| offset | optional | Integer offset into results, 0 based. Defaults to 0. | 0 |
Response Elements
| Response | Description |
|---|---|
| code |
Beats API response code. If successful, code is 'OK'. Otherwise it will be an error code. |
| info |
Container for paging information |
| offset |
Integer offset into results, 0 based. Always matches supplied argument value. |
| count |
Number of results returned for this request. |
| total |
Total number of elements available for this resource |
Example Request
curl -X GET https://partner.api.beatsmusic.com/v1/api/genres?
client_id=[CLIENT_ID]Example Response
{
data: [
{
id: "eg77531656587575297",
username: "beatsalternative",
name: "Beats Alternative",
verified: true,
total_follows: 0,
total_followed_by: 11486,
playlist_count: 562,
type: "genre"
},
{
id: "eg77531656801484800",
username: "beatsamericana",
name: "Beats Americana",
verified: true,
total_follows: 0,
total_followed_by: 1030,
playlist_count: 84,
type: "genre"
},
...
{
id: "eg77531656885370880",
username: "beatsreggae",
name: "Beats Reggae",
verified: true,
total_follows: 0,
total_followed_by: 4284,
playlist_count: 158,
type: "genre"
}
],
info: {
offset: 0,
count: 20,
total: 20
},
code: "OK"
}
