ToolzerHub Docs

Get top charts (v1)

A whole Shazam chart in one call, ranked by Shazams over the past 7 days: worldwide or country top 200, city top 50, or a genre chart. Each song has its rank, artist and title. The chart locations endpoint lists the cities and genres ranked.

1 credit / requestBilled only on success
GET
/v1/shazam/charts

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

country?string

An ISO country code such as US, GB or IN, or a country name. Omit for the worldwide chart. GET /v1/shazam/chart-locations lists the 70 countries Shazam ranks.

Lengthlength <= 80
Default""
city?string

A city Shazam ranks in the given country, such as New York City, London or Mumbai, for its top 50. Needs country, and cannot be combined with genre.

Lengthlength <= 80
Default""
genre?string

A genre such as Pop, Hip-Hop/Rap, Dance or Country, for that genre's chart worldwide or in the given country. Cannot be combined with city.

Lengthlength <= 80
Default""
curl -X GET "https://example.com/v1/shazam/charts" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "chart_type": "world",    "country": "US",    "city": "New York City",    "genre": null,    "chart_date": "2026-11-05",    "period": "performance over the past 7 days",    "count": 50,    "entries": [      {        "rank": 1,        "artist": "KAROL G, Judeline & rusowsky",        "title": "BbY WOW"      }    ],    "url": "https://www.shazam.com/charts/top-50/united-states/new-york-city"  },  "details": {    "reason": "string",    "message": "string"  }}