Charts

List Chart Countries for Platform

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.

get/api/charts/{platform}/countries

Request

Base URL
https://api.chartmetric.com
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.

Path parameters

Chart platform (e.g. airplay, amazon, applemusic, deezer, itunes, shazam, soundcloud, spotify, tiktok, youtube).

Query parameters

'tracks' | 'artists'

'tracks' | 'albums'

'albums' | 'tracks' | 'videos'

'tracks'

'artists' | 'tracks' | 'trends' | 'videos' | 'shorts'

'daily' | 'weekly'

'popular_track' | 'new_track' | 'popular_album' | 'new_album'

'top' | 'daily'

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.