API Documentation - Yo Radio API

Quick Start

All data is available as static JSON files. No API keys required. Simply fetch the data directly:

// Fetch all stations
fetch('https://shubhamnpk.github.io/yoradio-api/data/index.json')
  .then(res => res.json())
  .then(stations => console.log(stations));

Data Endpoints

JSON /data/index.json

Complete database of all radio stations (400+ stations).

Response Schema

[
  {
    "id": "radio-kantipur-96.1",
    "name": "Radio Kantipur",
    "streamUrl": "https://radio-broadcast.ekantipur.com/stream",
    "frequency": 96.1,
    "address": "Subidhanagar, Tinkune, Kathmandu",
    "province": 3,
    "status": "active"
  }
]

Fields

Field	Type	Description
id	string	Unique identifier for the station
name	string	Station name
streamUrl	string	Direct streaming URL
frequency	number \| null	FM frequency in MHz
address	string	Station location/address
province	number	Province code (1-7)
status	string	active \| inactive

JSON /data/active.json

Only verified active stations with working stream URLs. Use this for production apps.

// Same schema as index.json, filtered for active stations only
fetch('data/active.json')
  .then(res => res.json())
  .then(stations => {
    // All stations here have verified working streams
  });

JSON /data/old.json

Stations with broken or invalid stream URLs. Includes validation error details.

{
  "id": "old-station",
  "name": "Old Radio",
  "streamUrl": "https://dead-url.com/stream",
  "_validation": {
    "valid": false,
    "message": "HTTP 404 - Not Found",
    "checked_at": "2024-01-15 10:30:00 UTC"
  }
}

Province Codes

1

Koshi Province

Eastern Nepal

2

Madhesh Province

Terai Region

3

Bagmati Province

Kathmandu Valley

4

Gandaki Province

Western Central

5

Lumbini Province

Birthplace of Buddha

6

Karnali Province

Remote Western

7

Sudurpashchim

Far Western

Code Examples

Filter by Province

async function getBagmatiStations() {
  const response = await fetch('data/index.json');
  const stations = await response.json();
  
  return stations.filter(station => station.province === 3);
}

Search Stations

function searchStations(stations, query) {
  const lowerQuery = query.toLowerCase();
  return stations.filter(station => 
    station.name.toLowerCase().includes(lowerQuery) ||
    (station.address && station.address.toLowerCase().includes(lowerQuery))
  );
}

Load and Filter Data

import json
import urllib.request

def get_stations_by_province(province_code):
    with urllib.request.urlopen('data/index.json') as response:
        stations = json.load(response)
    
    return [s for s in stations if s['province'] == province_code]

# Get all Bagmati stations
bagmati = get_stations_by_province(3)
print(f"Found {len(bagmati)} stations in Bagmati")

Play Radio Stream

import vlc

def play_station(stream_url):
    player = vlc.MediaPlayer(stream_url)
    player.play()
    return player

# Play Radio Kantipur
player = play_station('https://radio-broadcast.ekantipur.com/stream')

Custom Hook

import { useState, useEffect } from 'react';

function useRadioStations() {
  const [stations, setStations] = useState([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    fetch('data/index.json')
      .then(res => res.json())
      .then(data => {
        setStations(data);
        setLoading(false);
      });
  }, []);

  return { stations, loading };
}