Spotify

Retrieve Spotify featured charts by country

Returns Spotify country hub content. Defaults to the CHARTS content shelf for the requested country.

get/spotify/featured-charts-by-country

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/spotify/featured-charts-by-country
  • Auth: API key in header x-api-key

Query parameters

country_codestring

Two-letter Spotify popular-in country code

content_id'CHARTS' | 'POPULAR_ALBUMS' | 'POPULAR_ARTISTS' | 'TRENDING_SONGS'

Country hub content ID. Allowed: CHARTS, POPULAR_ALBUMS, POPULAR_ARTISTS, TRENDING_SONGS

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "contentId": "CHARTS",
    "countryCode": "US",
    "countryName": "United States",
    "hexColor": "#1DB954",
    "items": [
      {
        "album": {
          "description": "The official podcast of comedian Joe Rogan.",
          "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
          "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
          "images": [
            {
              "height": 640,
              "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
              "width": 640
            }
          ],
          "publisher": "Joe Rogan",
          "subtitle": "Joe Rogan",
          "title": "The Joe Rogan Experience",
          "type": "Podcast",
          "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
        },
        "artists": [
          {
            "description": "The official podcast of comedian Joe Rogan.",
            "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
            "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
            "images": [
              {
                "height": 640,
                "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
                "width": 640
              }
            ],
            "publisher": "Joe Rogan",
            "subtitle": "Joe Rogan",
            "title": "The Joe Rogan Experience",
            "type": "Podcast",
            "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
          }
        ],
        "attributes": {
          "{\"chart\"": "\"top-50\"}"
        },
        "description": "Your daily update of the most played tracks right now.",
        "externalUrl": "https://open.spotify.com/playlist/37i9dQZEVXbLRQDuF5jeBpM",
        "imageUrl": "https://charts-images.scdn.co/assets/locale_en/regional/daily/region_us_default.jpg",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "owner": {
          "description": "The official podcast of comedian Joe Rogan.",
          "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
          "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
          "images": [
            {
              "height": 640,
              "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
              "width": 640
            }
          ],
          "publisher": "Joe Rogan",
          "subtitle": "Joe Rogan",
          "title": "The Joe Rogan Experience",
          "type": "Podcast",
          "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
        },
        "subtitle": "Spotify",
        "title": "Top 50 - USA",
        "type": "Playlist",
        "uri": "spotify:playlist:37i9dQZEVXbLRQDuF5jeBpM"
      }
    ],
    "meta": {
      "appVersion": "1.2.90.403.gf901f20f",
      "fetchedAt": "2026-05-13T20:41:13Z",
      "itemCount": 20,
      "operationName": "countryHubContent",
      "partialErrors": 1
    },
    "supportedContentIds": [
      {
        "id": "CHARTS",
        "title": "Featured Charts"
      }
    ],
    "supportedCountries": [
      {
        "code": "us",
        "name": "United States"
      }
    ],
    "title": "Featured Charts"
  }
}

Changes

No recorded changes to this operation across all 4 revisions of this API.