🔌 API Dokumentace

Katalog TopRadio.cz nabízí vývojářům bezplatné API pro získání aktuálního seznamu schválených a aktivních internetových rádií včetně jejich poslechovosti v reálném čase. Data lze snadno integrovat do mobilních aplikací, IPTV platforem či jiných webových projektů.

1. REST API Endpointy

👉 Výchozí JSON formát

Nejčastěji používaný formát pro moderní webové a mobilní aplikace.

GET https://katalog.topradio.cz/api/export.php

👉 Alternativní XML formát

Vhodný pro starší systémy, RSS čtečky nebo firemní integrace.

GET https://katalog.topradio.cz/api/export.php?format=xml

2. Struktura datových položek

API vrací seznam rádií seřazený sestupně podle aktuální poslechovosti. Obsahuje následující klíče:

• id: Unikátní identifikátor rádia v našem katalogu
• name: Oficiální název rádia
• stream_url: Primární URL adresa streamu (nejvyšší kvalita)
• stream_url_2 / stream_url_3: Záložní streamy nebo nižší kvality audia
• genre: Hlavní hudební žánr rádia
• region: Region nebo kraj vysílání
• website: Odkaz na oficiální webové stránky rádia
• description: Krátký textový popis rádia (max 60 znaků)
• logo: URL adresa profilového obrázku/loga
• listeners: Aktuální počet posluchačů (číslo je obnovováno každou minutu)

3. Ukázka JSON odpovědi

{
  "radios": [
    {
      "id": 1,
      "name": "Hitrádio",
      "stream_url": "http://live.topradio.cz:8000/crazy128",
      "stream_url_2": "http://live.topradio.cz:8000/crazy64",
      "stream_url_3": "http://live.topradio.cz:8000/crazy32",
      "genre": "Pop",
      "region": "Celostátní / Nespecifikováno",
      "website": "https://crazyradio.cz",
      "description": "Nejlepší hity na jednom místě.",
      "logo": "https://crazyradio.cz/logo.png",
      "listeners": 154
    }
  ]
}