# Open Radio Player

Public radio stream data API for apps, agents, games, and integrations.

Primary docs:
- Developer docs: https://openradioplayer.com/developers
- Live API status: https://openradioplayer.com/api
- OpenAPI schema: https://openradioplayer.com/openapi.json

Primary JSON endpoints:
- Healthy stations: https://openradioplayer.com/api/v1/stations/healthy
- Full telemetry: https://openradioplayer.com/api/v1/stations/telemetry
- System status: https://openradioplayer.com/api/v1/system/status
- Station catalog: https://openradioplayer.com/api/v1/stations/index.json

Integration notes:
- Authentication: none
- CORS: Access-Control-Allow-Origin: *
- Healthy/telemetry cache: public, s-maxage=60, stale-while-revalidate=300
- System status cache: no-store, max-age=0
- Check generatedAt and telemetryGeneratedAt for freshness

Recommended usage:
- Start with /api/v1/stations/healthy for smaller, reliable result sets
- Use /api/v1/stations/telemetry for full stream-variant telemetry and failure counters
- Use /api/v1/system/status before agent jobs or demos that require fresh data
- Join /api/v1/stations/index.json with telemetry by streamId/defaultStreamId for stable metadata plus live health