SOUND.RADAR API DEV
NOINDEX Docs

Charts API

Spotify Charts

Spotify chart endpoints for country lists, latest charts, historical dates, track search, and track history.

Overview

What this API is for

Spotify chart endpoints for country lists, latest charts, historical dates, track search, and track history. Use this branded guide for orientation, then use the original Swagger page for full schemas and interactive testing.

Access

Public path and credentials

Basehttps://api.soundradar.co/spotify
AuthUse issued API key headers for protected data endpoints. Never ship credentials in browser code.
SchemaOpenAPI JSON and Swagger UI remain available.

Endpoints

Available routes

GET /spotify/

Root

No query/path parameters listed.
GET /spotify/health

Health

No query/path parameters listed.
GET /spotify/countries

Countries

x-api-key
GET /spotify/latest

Latest Chart

countrychart_typelimitx-api-key
GET /spotify/chart

Chart By Date

countrychart_typechart_daterequiredlimitx-api-key
GET /spotify/dates

Available Dates

countrychart_typex-api-key
GET /spotify/search

Search Track

qrequiredcountrychart_typelimitx-api-key
GET /spotify/history

Track History

artistrequiredtitlerequiredcountrychart_typex-api-key
GET /spotify/fetch-logs

Fetch Logs

statuslimitx-api-key

Examples

Request examples

curl https://api.soundradar.co/spotify/health
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  https://api.soundradar.co/spotify/countries

Operations

Implementation notes

  • Use public paths only. Internal ports are operational details.
  • Check health before debugging application code.
  • Prefer typed handling for nullable response fields.
  • Coordinate API key changes before partner deployments.