SOUND.RADAR API DEV
NOINDEX Docs

Charts API

Billboard Charts

Billboard chart snapshots, latest rankings, preset views, date-based views, and entry search.

Overview

What this API is for

Billboard chart snapshots, latest rankings, preset views, date-based views, and entry search. 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/billboard
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 /billboard/

Root

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

Health

No query/path parameters listed.
GET /billboard/charts

List Charts

No query/path parameters listed.
GET /billboard/charts/{chart_slug}/snapshots

List Snapshots

chart_slugrequiredlimit
GET /billboard/charts/{chart_slug}/dates

List Chart Dates

chart_slugrequiredlimit
GET /billboard/charts/{chart_slug}/latest

Latest Chart

chart_slugrequiredlimitinclude_raw
GET /billboard/charts/{chart_slug}/preset

Chart By Preset

chart_slugrequiredpresetlimitinclude_raw
GET /billboard/charts/{chart_slug}/weeks-ago/{weeks_ago}

Chart By Weeks Ago

chart_slugrequiredweeks_agorequiredlimitinclude_raw
GET /billboard/charts/{chart_slug}/{chart_date}

Chart By Date

chart_slugrequiredchart_daterequiredlimitinclude_raw
GET /billboard/search

Search Entries

qrequiredchart_sluglimit

Examples

Request examples

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

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.