Radioguide Data API
Radiodataa sovelluksiin, autoihin, televisioihin ja verkkosivuille
Yli 100 000 radioasemaa, joiden striimiosoitteet tarkistamme päivittäin, logot, genret ja maat. Lisäksi mitä nyt soi, radion soitetuimmat kappaleet ja muutossyöte, jolla pidät kopiosi ajan tasalla.
# Jazzasemat Alankomaissa 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", ...} }] }
Mitä saat
Yksi API kaikkeen, mitä tiedämme radiosta.
Asemat ja striimit
Hae nimen, maan, genren ja kielen mukaan. Jokainen striimiosoite muotoineen ja toisiaan muistuttavat asemat.
Striimien kunto
Tarkistamme striimit itse: verkossa vai ei, koodekki, bittinopeus ja käytettävyys 30 päivän ajalta. Ei enää kuolleita asemia sovelluksessasi.
Nyt soi
Nyt soiva kappale ja sitä edeltävät, luettuna tuhansien asemien striimeistä.
Radiolistat
Radion soitetuimmat kappaleet ja artistit maittain ja genreittäin, soittokerrat päivittäin.
Radioguide Channels
Omat kanavamme, joilla soi riippumattomien artistien uutta musiikkia: mitä nyt soi ja seuraavien kappaleiden aikataulu.
Pysy synkronissa
Muutossyöte, täysi päivittäinen vienti ja webhookit, kun asema muuttuu, striimi katkeaa tai uusi kappale alkaa.
Ketkä sitä käyttävät
Radiosovellukset
Tee radiosovellus ylläpitämättä omaa asemaluetteloa: haku, logot, toimivat striimit ja mitä nyt soi.
Developer tai ProAuto-, tv- ja laitevalmistajat
Nettiradio kojelaudoissa, älytelevisioissa, digibokseissa ja wifi-radioissa, logot kaikissa koissa ja päivittäin tarkistetut striimit.
Business tai datalisenssiMusiikkiala ja analytiikka
Näe, mitä kappaleita ja artisteja radio soittaa, missä ja kuinka usein. Levy-yhtiöille, promoottoreille ja markkinatutkimukseen.
Pro tai BusinessVerkkosivustot ja widgetit
Näytä paikalliset asemat, top-lista tai mitä nyt soi omalla sivustollasi.
Free tai DeveloperPaketit
Aloita ilmaiseksi. Päivitä, kun julkaiset; peru minä kuukautena tahansa.
Free
- 1 000 kutsua päivässä
- 30 kutsua minuutissa
- Ei-kaupallinen käyttö
- "Powered by Radioguide.fm" linkin kanssa on pakollinen
- Logot ja striimien tila
- Nyt soi
- Radiolistat
- Käytettävyys, koodekki ja bittinopeus
- Muutossyöte ja webhookit
- Täysi päivittäinen vienti
Developer
- 50 000 kutsua päivässä
- 300 kutsua minuutissa
- Kaupallinen käyttö yhdessä sovelluksessa tai sivustossa
- Logot ja striimien tila
- Nyt soi
- Radiolistat
- Käytettävyys, koodekki ja bittinopeus
- Muutossyöte ja webhookit
- Täysi päivittäinen vienti
Pro
- 500 000 kutsua päivässä
- 1 500 kutsua minuutissa
- Kaupallinen käyttö yhdessä sovelluksessa tai sivustossa
- Logot ja striimien tila
- Nyt soi
- Radiolistat
- Käytettävyys, koodekki ja bittinopeus
- Muutossyöte ja webhookit
- Täysi päivittäinen vienti
Business
- 5 000 000 kutsua päivässä
- 6 000 kutsua minuutissa
- Kaupallinen käyttö useissa sovelluksissa
- Logot ja striimien tila
- Nyt soi
- Radiolistat
- Käytettävyys, koodekki ja bittinopeus
- Muutossyöte ja webhookit
- Täysi päivittäinen vienti
- 99,9 %:n käytettävyys-SLA
Enterprise
- Omat rajat ja datalisenssi
- Kaupallinen käyttö useissa sovelluksissa
- Logot ja striimien tila
- Nyt soi
- Radiolistat
- Käytettävyys, koodekki ja bittinopeus
- Muutossyöte ja webhookit
- Täysi päivittäinen vienti
- 99,95 %:n käytettävyys-SLA
Hinnat ovat ilman ALV:tä. ALV lisätään kassalla.
Pikaopas
Luo ilmainen avain
Kirjaudu sisään, nimeä projektisi ja kopioi avain. Se näytetään vain kerran.
Tee ensimmäinen kutsusi
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"
Käytä selaimessa
Avaimet toimivat palvelimeltasi. Kun kutsut tehdään verkkosivulta, lisää verkkotunnuksesi avaimeen portaalissa; muut sivustot eivät voi silloin käyttää sitä.
const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();Radioguide tekoälyavustajissa
MCP-palvelimemme avulla Claude, ChatGPT ja muut avustajat hakevat asemia, näkevät mitä soi, löytävät radiossa soivia kappaleita ja lukevat radiolistoja, linkein asemasivuille.
Claude
Claudessa (verkko tai työpöytä): Asetukset, Liittimet, Lisää mukautettu liitin. Nimi: Radioguide. Osoite:
https://www.radioguide.fm/mcp
Claude Code:
claude mcp add --transport http radioguide https://www.radioguide.fm/mcp --header "Authorization: Bearer rg_live_..."
Claude Desktopin asetustiedosto (claude_desktop_config.json) API-avaimellasi:
{
"mcpServers": {
"radioguide": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.radioguide.fm/mcp",
"--header",
"Authorization:${RADIOGUIDE_AUTH}"
],
"env": {
"RADIOGUIDE_AUTH": "Bearer rg_live_..."
}
}
}
}
ChatGPT
ChatGPT:ssä: Asetukset, Sovellukset ja liittimet, Lisäasetukset: ota kehittäjätila käyttöön. Luo sitten liitin tällä osoitteella ilman todennusta:
https://www.radioguide.fm/mcp
ChatGPT:ssä näkyy asemakortteja toistopainikkeella (beta).
Oma GPT Actions-toiminnoilla: tuo skeema tästä osoitteesta ja valitse todennukseksi API key, Bearer:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Muut MCP-asiakkaat
Mikä tahansa Streamable HTTP -siirtoa tukeva asiakas toimii: lähetä JSON-RPC-viestit POST-pyynnöllä osoitteeseen. Esimerkki:
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"}}}'
Asiakkaat, jotka eivät voi lähettää otsakkeita, lisäävät avaimen osoitteeseen: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Käytä tähän erillistä avainta.
Ilman avainta: 20 työkalukutsua minuutissa ja 300 päivässä verkkoa kohden, enintään 5 tulosta vastausta kohden. API-avaimella jokainen työkalukutsu lasketaan yhdeksi pakettisi API-kutsuksi.
Avustajien on mainittava Radioguide.fm lähteenä ja linkitettävä mainitsemiinsa asemasivuihin. Jokainen työkalun tulos sisältää linkin ja lähdemaininnan.
Rakennatko avustajaa, hakukonetta tai musiikkipalvelua? Lisensoi jäsennelty asema-, nyt soi- ja listadatamme: päivittäiset viennit, muutossyöte, korkeat rajat ja sopimus lähdemaininnasta.
- Asematiedot ja päivittäin tarkistetut striimit
- Nyt soivat kappaleet ja radiolistat tuhansilta asemilta
- Lähdemaininta: näytä Radioguide.fm lähteenä ja linkki asemasivulle kaikkialla, missä tietoja näytetään
Free-paketilla voit käyttää dataa ei-kaupallisissa projekteissa, kun näytät "Powered by Radioguide.fm" ja linkin sivustollemme kaikkialla, missä data näkyy. Jokainen vastaus sisältää tekstin kentässä meta.attribution.
<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>
API-dokumentaatio OpenAPI 3.1 MCP Muutosloki Striimien tila Käyttöehdot Datalisenssi