---
title: "List Chart Genres for Platform"
method: GET
path: "/api/charts/genres/{platform}"
tags: ["Charts"]
---

# List Chart Genres for Platform

`GET /api/charts/genres/{platform}`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/charts/genres/{platform}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/charts/genres/:platform/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the available chart genres for the given `platform` (optionally filtered by `code2`). Shape is highly platform-dependent — Amazon returns `[{ id, name }]`, Apple Music / iTunes / Beatport return hardcoded string arrays, SoundCloud / Anghami / Siriusxm return DB-backed string arrays, and Melon / Tencent return DB-backed object arrays. The envelope `{ obj: [...] }` is always a list but the element type varies per platform.

## Path parameters

- `platform` 'amazon' | 'amazon_albums' | 'apple_music' | 'apple_music_albums' | 'apple_music_videos' | 'beatport' | 'itunes' | 'itunes_albums' | 'itunes_videos' | 'line_daily' | 'melon_daily' | 'melon_monthly' | 'melon_weekly' | 'melon_yearly' | 'shazam_genre' | 'soundcloud' | 'soundcloud_legacy' | 'soundcloud_trending' | 'siriusxm' | 'tencent_weekly' | 'tencent_monthly' | 'anghami' | 'genius', required: Chart platform whose genre list is returned (e.g. `amazon`, `applemusic`, `itunes`, `soundcloud`, `melon`).

## Query parameters

- `code2` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

## Response `200`

Success

- object
  - `obj` union[], nullable: List of available chart genres. Element is a string on most platforms; `{ id, name }` object on Amazon / Melon / Tencent.
    - union
      - string
      - object
        - `id` union: Genre ID (Amazon, Melon, Tencent).
          - string
          - number, float
        - `name` string, nullable: Genre name.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)