Radioguide Data API

Radio data for apps, cars, TVs and websites

More than 100,000 radio stations with stream URLs we check every day, logos, genres and countries. Plus what is playing now, the most played songs on the radio and a change feed to keep your copy up to date.

Get a free key Read the docs Data licence for devices

# Jazz stations in the Netherlands
curl -H "X-Api-Key: rg_live_..." \
  "https://www.radioguide.fm/api/v2/stations?country=NL&genre=jazz"

{
  "data": [{
    "id": "64f1c2a9e4b0a1b2c3d4e5f6",
    "name": "Jazz Radio Amsterdam",
    "country": "NL",
    "genres": ["jazz"],
    "stream_url": "https://...",
    "stream_ok": true,
    "now_playing": {"artist": "Chet Baker", ...}
  }]
}

16,056radio stations

201countries

–of checked streams online

0stations with now playing

What you get

One API for everything we know about radio.

Stations and streams

Search by name, country, genre and language. Every stream URL with format, and stations that look like each other.

Stream health

We check the streams ourselves: online or not, codec, bitrate and uptime over 30 days. No more dead stations in your app.

Now playing

The track on air and the tracks before it, read from the streams of thousands of stations.

Radio charts

The most played songs and artists on the radio, per country and genre, with plays per day.

Radioguide Channels

Our own channels with new music from independent artists: now playing and the schedule of the next tracks.

Stay in sync

A change feed, a full daily export and webhooks when a station changes, a stream goes down or a new track starts.

Who uses it

Radio apps

Build a radio app without maintaining a station list: search, logos, working streams and now playing.

Developer or Pro

Car, TV and hardware makers

Internet radio in dashboards, smart TVs, set-top boxes and Wi-Fi radios, with logos in every size and daily checked streams.

Business or data licence

Music industry and analytics

See which songs and artists the radio plays, where and how often. For labels, promoters and market research.

Pro or Business

Websites and widgets

Show local stations, a top list or what is playing now on your own site.

Free or Developer

Plans

Start free. Upgrade when you go live; cancel any month.

Free

1,000 calls per day
30 calls per minute
Non-commercial use
"Powered by Radioguide.fm" with a link required
Logos and stream status
Now playing
Radio charts
Uptime, codec and bitrate
Change feed and webhooks
Full daily export

Get a free key

Developer

€29,00 per month

50,000 calls per day
300 calls per minute
Commercial use in one app or website
Logos and stream status
Now playing
Radio charts
Uptime, codec and bitrate
Change feed and webhooks
Full daily export

Choose Developer

Pro

€149,00 per month

500,000 calls per day
1,500 calls per minute
Commercial use in one app or website
Logos and stream status
Now playing
Radio charts
Uptime, codec and bitrate
Change feed and webhooks
Full daily export

Choose Pro

Business

€499,00 per month

5,000,000 calls per day
6,000 calls per minute
Commercial use in several apps
Logos and stream status
Now playing
Radio charts
Uptime, codec and bitrate
Change feed and webhooks
Full daily export
99.9% uptime SLA

Choose Business

Enterprise

from €750,00 per month

Custom limits and data licence
Commercial use in several apps
Logos and stream status
Now playing
Radio charts
Uptime, codec and bitrate
Change feed and webhooks
Full daily export
99.95% uptime SLA

Prices exclude VAT. VAT is added at checkout.

See all plans and prices

Quick start

Create a free key

Make your first call

curl -H "X-Api-Key: $RADIOGUIDE_KEY" "https://www.radioguide.fm/api/v2/search?q=jazz&country=US"
curl -H "X-Api-Key: $RADIOGUIDE_KEY" "https://www.radioguide.fm/api/v2/stations/64f1c2a9e4b0a1b2c3d4e5f6"
curl -H "X-Api-Key: $RADIOGUIDE_KEY" "https://www.radioguide.fm/api/v2/charts?country=NL&days=7"

Use it in the browser

Keys work from your server. For calls from a web page, add your domain to the key in the portal; other sites cannot use it.

const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();

Radioguide in AI assistants

Our MCP server lets Claude, ChatGPT and other assistants search stations, see what is playing, find songs on air and read the radio charts, with links to the station pages.

Claude

In Claude (web or desktop): Settings, Connectors, Add custom connector. Name: Radioguide. URL:

https://www.radioguide.fm/mcp

Claude Code:

claude mcp add --transport http radioguide https://www.radioguide.fm/mcp --header "Authorization: Bearer rg_live_..."

Claude Desktop config file (claude_desktop_config.json), with your API key:

{
    "mcpServers": {
        "radioguide": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://www.radioguide.fm/mcp",
                "--header",
                "Authorization:${RADIOGUIDE_AUTH}"
            ],
            "env": {
                "RADIOGUIDE_AUTH": "Bearer rg_live_..."
            }
        }
    }
}

ChatGPT

In ChatGPT: Settings, Apps and Connectors, Advanced settings: turn on developer mode. Then create a connector with this URL and no authentication:

https://www.radioguide.fm/mcp

Station cards with a play button appear in ChatGPT (beta).

Custom GPT with Actions: import the schema from this URL and choose API key, Bearer, as authentication:

https://www.radioguide.fm/api/openapi.json?profile=gpt

Other MCP clients

Any client with the Streamable HTTP transport works: send JSON-RPC messages with POST to the URL. Example:

curl -s https://www.radioguide.fm/mcp -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}}}'

curl -s https://www.radioguide.fm/mcp -H "Content-Type: application/json" \
  -H "Authorization: Bearer rg_live_..." \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stations","arguments":{"genre":"jazz","country":"FR"}}}'

Clients that cannot send headers can add the key to the URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Use a separate key for this.

Limits and credit

Without a key: 20 tool calls per minute and 300 per day per network, with up to 5 results per answer. With an API key, every tool call counts as one API call of your plan.

Assistants must name Radioguide.fm as the source and link to the station pages they mention. Every tool result contains the link and the credit.

AI and data partners

Do you build an assistant, a search engine or a music service? License our structured station, now-playing and charts data, with daily exports, a change feed, high limits and an agreement on attribution.

Station data with streams we check every day
Now playing and radio charts from thousands of stations
Attribution: show Radioguide.fm as the source with a link to the station page wherever the data appears

Ask for a proposal

Free plan: show the credit

On the Free plan you may use the data for non-commercial projects when you show "Powered by Radioguide.fm" with a link to our site wherever the data appears. Every answer contains the text in meta.attribution.

<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>

API reference OpenAPI 3.1 MCP Changelog Stream status Terms of use Data licence