RM Radio API

API Reference

Endpoints

GET /api/v1/stations

Returns a list of radio stations. Filter by country, genre or language.

Parameter	Type	Description
`country`	`string`	ISO 3166-1 alpha-2 (e.g. `FR`, `JP`, `DE`, `CH`, `US`)
`genre`	`string`	Genre filter (e.g. `jazz`, `news`, `pop`)
`limit`	`integer`	Results per page (default: 50, max: 500)
`offset`	`integer`	Pagination offset

# Example request
GET /api/v1/stations?country=FR&limit=5

# Response
{
  "status": "ok",
  "total": 2847,
  "stations": [
    {
      "id": "fr-001",
      "name": "France Inter",
      "country": "FR",
      "genre": ["news", "culture"],
      "stream_url": "https://icecast.radiofrance.fr/franceinter-hifi.aac",
      "homepage": "https://www.radiofrance.fr/franceinter",
      "bitrate": 128,
      "active": true
    }
  ]
}

GET/api/v1/stations/{id}

Returns detailed information about a specific radio station by its unique ID.

GET/api/v1/countries

Returns all countries in the directory with station counts.

GET/api/v1/genres

Returns all available genres with station counts.

Why RM Radio API

Built for developers

⚡

Commercial Use Authorized

Explicitly permitted in our Terms of Use. Build free or paid apps with or without advertising.

🎙

Broadcaster Self-Service

Stations can register, update their info, or request removal via our self-service portal.

🌍

Global Coverage

150+ countries including France, Japan, Germany, Switzerland, USA and more.

🔒

24h Takedown Policy

Any broadcaster can request removal within 24 hours. Full DMCA compliance.

📡

Directory Model

We link — we don't host. All streams point directly to broadcasters' own servers.

⚙️

No Auth Required

No API key needed for standard usage. Plug in and start building immediately.

This API may be used in free and non-free (commercial) software