🎼 Genres

Musical genre classifications for accurate content categorization

Resource Overview

Genres provide standardized musical categorization for albums and tracks. This reference data helps with music discovery, platform distribution requirements, and catalog organization. Genres are read-only reference data.

Base Endpoint
/genres
Resource Type
genres
Access Level
Read-only reference data

Schema

Read-only Attributes

Field Type Description
id string Unique identifier
name string Official genre name (e.g., "Rock", "Electronic", "Jazz")

Usage in Other Resources

🔗 Related Resources

  • • Albums: Primary and secondary genre classification
  • • Tracks: Primary and secondary genre assignment
  • • Unique Constraint: Genre names are unique across the system
  • • Reference Data: Managed by system administrators

List Genres

GET /genres Read Only 
GET /genres
Authorization: Bearer {token}
Accept: application/vnd.api+json

Query Parameters

Filtering

  • • filter[name] - Filter by genre name
  • • filter[names] - Multiple names (comma-separated)

Other Parameters

  • • sort - Sort by name
  • • page[number] - Page number
  • • page[size] - Results per page

Example Request

GET /genres?sort=name&page[size]=50

Success Response

200 OK 
{
  "data": [
    {
      "type": "genres",
      "id": "1",
      "attributes": {
        "name": "Alternative"
      }
    },
    {
      "type": "genres",
      "id": "2",
      "attributes": {
        "name": "Blues"
      }
    },
    {
      "type": "genres",
      "id": "3",
      "attributes": {
        "name": "Classical"
      }
    },
    {
      "type": "genres",
      "id": "4",
      "attributes": {
        "name": "Country"
      }
    },
    {
      "type": "genres",
      "id": "5",
      "attributes": {
        "name": "Electronic"
      }
    },
    {
      "type": "genres",
      "id": "6",
      "attributes": {
        "name": "Folk"
      }
    },
    {
      "type": "genres",
      "id": "7",
      "attributes": {
        "name": "Hip-Hop"
      }
    },
    {
      "type": "genres",
      "id": "8",
      "attributes": {
        "name": "Jazz"
      }
    },
    {
      "type": "genres",
      "id": "9",
      "attributes": {
        "name": "Pop"
      }
    },
    {
      "type": "genres",
      "id": "10",
      "attributes": {
        "name": "R&B"
      }
    },
    {
      "type": "genres",
      "id": "11",
      "attributes": {
        "name": "Reggae"
      }
    },
    {
      "type": "genres",
      "id": "12",
      "attributes": {
        "name": "Rock"
      }
    }
  ],
  "meta": {
    "page": {
      "current-page": 1,
      "per-page": 50,
      "total": 12,
      "last-page": 1
    }
  }
}

Get Single Genre

GET /genres/{id} 
GET /genres/12
Authorization: Bearer {token}
Accept: application/vnd.api+json

Success Response

200 OK 
{
  "data": {
    "type": "genres",
    "id": "12",
    "attributes": {
      "name": "Rock"
    }
  }
}

Popular Genres

🎸 Rock & Alternative

  • • Rock
  • • Alternative
  • • Indie Rock
  • • Hard Rock
  • • Progressive Rock

🎵 Pop & Mainstream

  • • Pop
  • • Pop Rock
  • • Indie Pop
  • • Synth Pop
  • • Dance Pop

🎤 Hip-Hop & Urban

  • • Hip-Hop
  • • R&B
  • • Soul
  • • Trap
  • • Neo-Soul

🎹 Electronic & Dance

  • • Electronic
  • • House
  • • Techno
  • • Ambient
  • • EDM

🎺 Jazz & Classical

  • • Jazz
  • • Classical
  • • Blues
  • • Fusion
  • • Contemporary

🌍 World & Regional

  • • World Music
  • • Latin
  • • Reggae
  • • Country
  • • Folk

Integration Guidelines

💡 Best Practices

  • • Cache genre list locally for performance
  • • Always assign a primary genre to albums
  • • Use secondary genres for sub-classification
  • • Validate genre IDs before creating content
  • • Consider DSP distribution requirements

✅ DSP Compatibility

  • • Genres map to Spotify categories
  • • Apple Music genre standards
  • • Amazon Music compatibility
  • • YouTube Music integration
  • • Industry-standard classifications

⚠️ Important Notes

  • • Genres are read-only reference data
  • • New genres require system admin approval
  • • Genre IDs remain stable across updates
  • • Primary genre is required for albums
  • • Secondary genres are optional

🎯 Music Discovery

  • • Improves playlist placement algorithms
  • • Enhances recommendation systems
  • • Optimizes search result relevance
  • • Enables genre-based radio stations
  • • Supports curator content discovery