SOUND.RADAR API DEV
NOINDEX Docs

Radio API

iHeartRadio

Radio station directory, current plays, station detail, monitored track history, and summary views.

Overview

What this API is for

Radio station directory, current plays, station detail, monitored track history, and summary views. 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/radio
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 /radio/

Home

No query/path parameters listed.
GET /radio/stations

Stations

limitoffsetqgenrecityx-api-key
GET /radio/stations/{station_id}

Station Detail

station_idrequiredx-api-key
GET /radio/current

Current

limitoffsetartisttitlex-api-key
GET /radio/current/{station_id}

Current Station

station_idrequiredx-api-key
GET /radio/history

History

station_idartisttitlelimitoffsetx-api-key
GET /radio/tracks

Tracks

qlimitoffsetx-api-key
GET /radio/summary

Summary

x-api-key

Examples

Request examples

curl https://api.soundradar.co/radio/openapi.json
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  https://api.soundradar.co/radio/stations

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.