Station metadata
GET / JSONReplace {slug} with the public station slug. This route has no write operation.
curl -sS -H 'Accept: application/json' 'https://aircastpanel.com/api/v1/estacion/{slug}'
Read public station metadata, build a player or directory, and keep your own product in sync with the signal. No private credentials are required for this API.
The public API is intentionally small: discover the station, request its state, render the useful fields, and refresh without creating unnecessary traffic.
Use the final segment of the public station URL. For example, radio-centro in /radio/radio-centro.
Replace {slug} with the public slug. The versioned route is the recommended contract for new integrations.
Send a GET request from your server or browser. It is read-only and does not change playlists, runtime or billing.
Cache the response for 15–30 seconds, handle timeouts and show a useful offline state when the network fails.
This response contains the state needed for a public player, radio directory, mobile app or custom website.
Replace {slug} with the public station slug. This route has no write operation.
curl -sS -H 'Accept: application/json' 'https://aircastpanel.com/api/v1/estacion/{slug}'
The exact values change with the station, but the structure remains stable within v1.
{\n "ok": true,\n "version": "v1",\n "estacion": {\n "slug": "radio-centro",\n "online": true,\n "cancion": "Artista - Título",\n "oyentes_actuales": 42,\n "bitrate": 128,\n "formato": "mp3",\n "url_stream": "https://tu-dominio.example/play/radio-centro.m3u",\n "url_cover": "https://tu-dominio.example/cover/radio-centro"\n }\n}
Use this first to confirm the station returns valid JSON from your server.
curl -sS -H 'Accept: application/json' 'https://aircastpanel.com/api/v1/estacion/{slug}'
The same request can run in a frontend when your application follows the browser CORS policy.
const response = await fetch("https://aircastpanel.com/api/v1/estacion/{slug}", {
headers: { Accept: 'application/json' },
cache: 'no-store'
});
const data = await response.json();
const station = data.estacion || {};
console.log(station.cancion || 'Sin metadata');
Use only the data you need and keep the UI resilient when metadata is empty.
estacion.online
Whether the public signal is currently reachable.
estacion.cancion
Current metadata, or an empty value when unavailable.
estacion.oyentes_actuales
Current listener count exposed by the station.
estacion.bitrate / formato
Technical information for player and directory labels.
estacion.url_stream
Public stream URL for an audio player.
estacion.url_cover
Public cover URL when the station has artwork.
Choose the resource that matches your use case. None of these routes grants control over the station.
The private API is a separate contract for billing platforms such as WHMCS. It uses Bearer tokens, scopes, rate limits and audit trails. Never use a public endpoint for account automation.