RadioMv API Documentation

Base URL

https://api.radiomv.com/v1

        

Endpoints

1. Get Aggregated Station Data

Endpoint: GET /stations.php

Description: Fetches and aggregates data from all radio station JSON files, returning the data in a single JSON response.

URL:

https://api.radiomv.com/v1/stations.php

        

Response:

[
    {
        "id": "1",
        "station": "English NT",
        "artist": "John Doe",
        "title": "Amazing Grace",
        "hlsStreamUrl": "https://stream.radiomv.com/english-nt.m3u8",
        "iceStreamUrl": "https://stream.radiomv.com/english-nt.mp3"
    },
    {
        "id": "2",
        "station": "German OT",
        "artist": "Jane Smith",
        "title": "Be Thou My Vision",
        "hlsStreamUrl": "https://stream.radiomv.com/german-ot.m3u8",
        "iceStreamUrl": "https://stream.radiomv.com/german-ot.mp3"
    }
    // More stations...
]

        

Individual Stations

The RadioMv API provides endpoints to access streaming information for various radio stations. Each station's data is available in JSON format, containing details such as the station name, current artist, title, and streaming URLs. Additionally, each station has a .txt endpoint that returns the current song title as plain text.

Base URL Structure

To access the streaming information for each station, use the following API URL structure:

https://api.radiomv.com/{station-name}.json

        

Replace {station-name} with the specific name of the station you want information for.

Example API Call

For example, to get information for the English station, use the following URL:

https://api.radiomv.com/english.json

        

Example JSON Output

{
  "id": "1",
  "station": "English",
  "artist": "Jack Hibbs",
  "title": "20240619",
  "hlsStreamUrl": "https://stream.radiomv.com/english.m3u8",
  "iceStreamUrl": "https://stream.radiomv.com/english.mp3"
}

        

Field Descriptions

Streaming Options

The API provides two options to receive the audio stream:

  1. HLS Stream URL (hlsStreamUrl): This is the HLS stream URL for the station, suitable for modern web browsers and media players that support HLS.
  2. Icecast Stream URL (iceStreamUrl): This is the Icecast (MP3) stream URL for the station, suitable for any player that supports MP3 streaming.

Song Title Text Endpoint

Each station also has a .txt endpoint that returns the current song title as plain text. Use the following URL structure:

https://api.radiomv.com/{station-name}.txt

        

For example, to get the current song title for the English station:

https://api.radiomv.com/english.txt

        

API URLs for All Stations with IDs