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

# List Chart Countries for Platform

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

## Request

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

Return the country codes with available chart data for the given `platform`. Query params (`chart_type`, `type`, `duration`) are needed for platforms whose chart countries vary by chart type / duration (e.g. Airplay, Amazon, Apple Music, iTunes, Spotify, TikTok, YouTube). Platforms with a single chart type (Deezer, Shazam, SoundCloud) do not need these params. The handler wraps the response in `{ obj: { countries } }` where `countries` depends on the platform — usually an array of ISO 3166-1 alpha-2 codes.

## Path parameters

- `platform` 'airplay' | 'amazon' | 'applemusic' | 'deezer' | 'itunes' | 'shazam' | 'soundcloud' | 'spotify' | 'tiktok' | 'youtube', required: Chart platform (e.g. `airplay`, `amazon`, `applemusic`, `deezer`, `itunes`, `shazam`, `soundcloud`, `spotify`, `tiktok`, `youtube`).

## Query parameters

- `chart_type` union: Chart type within the platform. Required for platforms whose country list varies by chart type; rejected for platforms with a single chart type (e.g. Deezer, Shazam, SoundCloud).
  - 'tracks' | 'artists'
  - 'tracks' | 'albums'
  - 'albums' | 'tracks' | 'videos'
  - 'tracks'
  - 'artists' | 'tracks' | 'trends' | 'videos' | 'shorts'
- `duration` union: Chart duration. Required for `platform=airplay`, and for `platform=youtube` with `chart_type=shorts`. Forbidden otherwise.
  - 'daily' | 'weekly'
  - 'daily' | 'weekly'
- `type` union: Chart sub-type. Required for `platform=amazon` (`new_album`, `new_track`, `popular_album`, `popular_track`) and for `platform=applemusic` with `chart_type=tracks` (`top`, `daily`, `city`).
  - 'popular_track' | 'new_track' | 'popular_album' | 'new_album'
  - 'top' | 'daily'

## Response `200`

Success

- object
  - `obj` object, nullable
    - `countries` union: Country codes available for the requested chart. Usually an array of ISO 3166-1 alpha-2 codes; some platforms emit nested maps when chart type / duration do not resolve to a single list.
      - union[]
        - union
          - string
          - object
      - object
      - string

---

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