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://taeon-studio.com/billboard-api
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-api/

Root

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

Health

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

List Charts

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

List Snapshots

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

List Chart Dates

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

Latest Chart

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

Chart By Preset

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

Chart By Weeks Ago

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

Chart By Date

chart_slugrequiredchart_daterequiredlimitinclude_raw
GET /billboard-api/billboard/search

Search Entries

qrequiredchart_sluglimit

Examples

Request examples

curl https://taeon-studio.com/billboard-api/health
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  https://taeon-studio.com/billboard-api/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.