---
title: "Shazam Chart Cities"
method: GET
path: "/api/charts/shazam/{country_code}/cities"
tags: ["Charts"]
---

# Shazam Chart Cities

`GET /api/charts/shazam/{country_code}/cities`

## Request

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

List of cities available for Shazam city-level filtering in a given country. Returns `cities: string[]` on success. When the country has no rows the handler returns `length: -1` and `cities: "Invalid Country or No Cities Found"` (legacy string fallback).

## Path parameters

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

## Response `200`

Success

- object
  - `obj` object
    - `length` integer, nullable: Number of cities in `cities` on success; `-1` when the country has no rows.
    - `cities` union: Array of Shazam city names for the country, or the legacy fallback string `"Invalid Country or No Cities Found"` when no rows match.
      - string[]
      - 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)