Endpoint Playground

Try the Spotify featured charts by country API

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

What a live request returned

14 Oct 2026: 4 items; 9 fields had a value in every checked item.

Observed request: GET /spotify/featured-charts-by-country?content_id=CHARTS&country_code=id
Fields with a value in every checked item: uri, type, title, subtitle, description, imageUrl, images, attributes

Sample value profiles: uri: “spotify:user:spotifycharts:playlist:37i9dQZEVXbIZK8aUquyx8” and 3 other values; imageUrl: charts-images.scdn.co; images: median 1 entry.

Request: GET /spotify/featured-charts-by-country
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.63 s
Monitored request: GET /spotify/featured-charts-by-country?content_id=POPULAR_ALBUMS&country_code=id

Spotify featured charts by country API documentation Spotify platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/spotify/featured-charts-by-country?content_id=CHARTS" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
country_code	string	No		Two-letter Spotify popular-in country code
content_id	string	No	CHARTS	Country hub content ID. Allowed: CHARTS, POPULAR_ALBUMS, POPULAR_ARTISTS, TRENDING_SONGS

Example JSON response

{
  "countryCode": "ID",
  "countryName": "Indonesia",
  "hexColor": "#F037A5",
  "contentId": "CHARTS",
  "title": "Featured Charts",
  "items": [
    {
      "uri": "spotify:playlist:37i9dQZEVXbObFQZ3JLcXt",
      "type": "Playlist",
      "title": "Top 50 - Indonesia",
      "subtitle": "Spotify",
      "description": "Your daily update of the most played tracks right now - Indonesia.",
      "externalUrl": "https://open.spotify.com/playlist/37i9dQZEVXbObFQZ3JLcXt",
      "attributes": {
        "rank_type": "plays",
        "chart_entity_type": "track"
      }
    }
  ],
  "meta": {
    "operationName": "countryHubContent",
    "itemCount": 1,
    "fetchedAt": "2026-05-13T20:03:43Z"
  }
}

More Spotify endpoints

Retrieve Spotify album details Retrieve Spotify album tracks Search Spotify albums Retrieve Spotify artist details Retrieve Spotify artist albums Retrieve Spotify artist playlists Retrieve Spotify related artists Search Spotify artists Retrieve Spotify audiobook details Retrieve Spotify audiobook chapters Search Spotify audiobooks Retrieve Spotify audiobook chapter details All 30 Spotify endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestspotify.countryHubContentResponseDocSpotify

GET /spotify/featured-charts-by-country

Retrieve Spotify featured charts by country

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

Response behavior

- `items` contains the selected country hub content, such as featured chart playlists for `CHARTS`. - Playlist rows preserve Spotify attributes such as `rank_type`, `last_updated`, `new_entries_count`, and `chart_entity_type` when present. - The response includes `supportedCountries` and `supportedContentIds` enums for clients that need selectable filters. - When Spotify returns a partial response, `meta.partialErrors` records the number of tolerated upstream field errors. Because this endpoint requests a single shelf, an upstream error with no surviving items fails as `503` (the requested content is genuinely unavailable) — try a different `content_id` if one shelf is temporarily broken upstream.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "countryCode": "ID",
  "countryName": "Indonesia",
  "hexColor": "#F037A5",
  "contentId": "CHARTS",
  "title": "Featured Charts",
  "items": [
    {
      "uri": "spotify:playlist:37i9dQZEVXbObFQZ3JLcXt",
      "type": "Playlist",
      "title": "Top 50 - Indonesia",
      "subtitle": "Spotify",
      "description": "Your daily update of the most played tracks right now - Indonesia.",
      "externalUrl": "https://open.spotify.com/playlist/37i9dQZEVXbObFQZ3JLcXt",
      "attributes": {
        "rank_type": "plays",
        "chart_entity_type": "track"
      }
    }
  ],
  "meta": {
    "operationName": "countryHubContent",
    "itemCount": 1,
    "fetchedAt": "2026-05-13T20:03:43Z"
  }
}

Endpoint Playground

Try the Spotify featured charts by country API

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

What a live request returned

14 Oct 2026: 4 items; 9 fields had a value in every checked item.

Observed request: GET /spotify/featured-charts-by-country?content_id=CHARTS&country_code=id
Fields with a value in every checked item: uri, type, title, subtitle, description, imageUrl, images, attributes

Sample value profiles: uri: “spotify:user:spotifycharts:playlist:37i9dQZEVXbIZK8aUquyx8” and 3 other values; imageUrl: charts-images.scdn.co; images: median 1 entry.

Request: GET /spotify/featured-charts-by-country
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.63 s
Monitored request: GET /spotify/featured-charts-by-country?content_id=POPULAR_ALBUMS&country_code=id

Spotify featured charts by country API documentation Spotify platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/spotify/featured-charts-by-country?content_id=CHARTS" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
country_code	string	No		Two-letter Spotify popular-in country code
content_id	string	No	CHARTS	Country hub content ID. Allowed: CHARTS, POPULAR_ALBUMS, POPULAR_ARTISTS, TRENDING_SONGS

Example JSON response

{
  "countryCode": "ID",
  "countryName": "Indonesia",
  "hexColor": "#F037A5",
  "contentId": "CHARTS",
  "title": "Featured Charts",
  "items": [
    {
      "uri": "spotify:playlist:37i9dQZEVXbObFQZ3JLcXt",
      "type": "Playlist",
      "title": "Top 50 - Indonesia",
      "subtitle": "Spotify",
      "description": "Your daily update of the most played tracks right now - Indonesia.",
      "externalUrl": "https://open.spotify.com/playlist/37i9dQZEVXbObFQZ3JLcXt",
      "attributes": {
        "rank_type": "plays",
        "chart_entity_type": "track"
      }
    }
  ],
  "meta": {
    "operationName": "countryHubContent",
    "itemCount": 1,
    "fetchedAt": "2026-05-13T20:03:43Z"
  }
}

More Spotify endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestspotify.countryHubContentResponseDocSpotify

GET /spotify/featured-charts-by-country

Retrieve Spotify featured charts by country

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

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "countryCode": "ID",
  "countryName": "Indonesia",
  "hexColor": "#F037A5",
  "contentId": "CHARTS",
  "title": "Featured Charts",
  "items": [
    {
      "uri": "spotify:playlist:37i9dQZEVXbObFQZ3JLcXt",
      "type": "Playlist",
      "title": "Top 50 - Indonesia",
      "subtitle": "Spotify",
      "description": "Your daily update of the most played tracks right now - Indonesia.",
      "externalUrl": "https://open.spotify.com/playlist/37i9dQZEVXbObFQZ3JLcXt",
      "attributes": {
        "rank_type": "plays",
        "chart_entity_type": "track"
      }
    }
  ],
  "meta": {
    "operationName": "countryHubContent",
    "itemCount": 1,
    "fetchedAt": "2026-05-13T20:03:43Z"
  }
}