Entrar Ver planes
Public API / integration guide

Connect your station without entering the panel.

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.

v1
Version
GET only
Method
No token
Public access
JSON
Format
Start in four steps

From public slug to usable metadata.

The public API is intentionally small: discover the station, request its state, render the useful fields, and refresh without creating unnecessary traffic.

01

Find the station slug

Use the final segment of the public station URL. For example, radio-centro in /radio/radio-centro.

02

Build the endpoint

Replace {slug} with the public slug. The versioned route is the recommended contract for new integrations.

03

Request JSON

Send a GET request from your server or browser. It is read-only and does not change playlists, runtime or billing.

04

Refresh responsibly

Cache the response for 15–30 seconds, handle timeouts and show a useful offline state when the network fails.

Recommended endpoint

Station metadata

This response contains the state needed for a public player, radio directory, mobile app or custom website.

Station metadata

GET / JSON
GET https://aircastpanel.com/api/v1/estacion/{slug}

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}'

Response shape

200 OK

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}

cURL example

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}'

Browser example

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');
Useful fields

Useful fields

Use only the data you need and keep the UI resilient when metadata is empty.

Useful fields

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.

Related public resources

Choose the resource that matches your use case. None of these routes grants control over the station.

GET
/api/v1/estacion/{slug} Recommended metadata
GET
/api/estacion/{slug} Legacy metadata
GET
/embed/{slug} Compact widget
GET
/embed/{slug}/full Full widget
GET
/play/{slug}.pls or .m3u Playlist download
GET
/api/openapi.json OpenAPI document
Integration rules that keep the signal healthy

Integration rules that keep the signal healthy

Do not place secrets in the browserPublic metadata needs no token. Provisioning and account operations are private and require a scoped Bearer token.
Use a cache and a timeoutA public page should not poll every second. Refresh on a sensible interval and keep the last valid response while retrying.
Treat missing metadata as normalA station can be online without a song title or cover. Display a clear fallback instead of failing the whole player.
Keep administrative actions privateThe public API never starts, stops, edits or deletes anything. Those operations belong to the authenticated provisioning API.

Need provisioning instead of metadata?

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.

View OpenAPI JSON ↗ Talk to support