RadioMV API

Access station configuration, program schedules, and metadata for RadioMV stations.

Base URL All API requests should be made to: https://api.radiomv.studio

Overview

The RadioMV API provides read-only access to station data through static JSON files. These files are designed for integration into mobile apps, web players, and third-party applications.

Available Endpoints

App Configuration

Station list, stream URLs, artwork, and app settings.

View documentation →

Schedule

Program schedules for main stations with times, categories, and descriptions.

View documentation →

Endpoints

App Configuration

GET /appv1.json

Legacy app config. Points to old schedule format.

GET /appv2.json

New app config. Points to v2 schedule format with improved schema.

Station Schedules (v2)

GET /english-programv2.json
GET /slavic-programv2.json
GET /spanish-programv2.json
GET /german-programv2.json

Returns program schedule for the specified station (v2 schema).

Quick Start

Fetch the app configuration to get all station data:

// JavaScript - use appv2 for new integrations
const response = await fetch('https://api.radiomv.studio/appv2.json');
const data = await response.json();

// Get main stations
const mainStations = data.stations.filter(s => s.isMain);
console.log(mainStations);

Fetch a station schedule:

// JavaScript - v2 schedule schema
const response = await fetch('https://api.radiomv.studio/english-programv2.json');
const schedule = await response.json();

// Get today's programs
const today = new Date().getDay();
const todayPrograms = schedule.schedule.filter(p => p.days.includes(today));
console.log(todayPrograms);

Stations

RadioMV operates 14 stations across 4 languages. Four main stations have full programming schedules:

ID Station Language Schedule
1 English en /english-programv2.json
4 Radio Cristiana en Español es /spanish-programv2.json
7 Deutsch RadioMv de /german-programv2.json
10 Христианское Радио ru /slavic-programv2.json

Additional stations (Bible reading channels, music, kids) are available in appv2.json but do not have separate schedule files.

Versioning

The API uses different versioning strategies for different file types:

File Version Field Format Purpose
appv1.json config.version YYYYMMDD.HHMM Cache invalidation
Schedule files schemaVersion Semantic (1.0.0) Schema compatibility
Schedule files lastUpdated ISO 8601 date Content freshness
Breaking Changes When schemaVersion major version changes (e.g., 1.x.x to 2.x.x), expect breaking changes that may require updates to your integration.