Radioguide Data API
Uygulamalar, otomobiller, TV'ler ve web siteleri için radyo verileri
Her gün kontrol ettiğimiz yayın adresleri, logolar, türler ve ülkelerle 100.000'den fazla radyo istasyonu. Ayrıca şu an çalanlar, radyoda en çok çalınan şarkılar ve kopyanı güncel tutmak için bir değişiklik akışı.
# Hollanda'daki caz istasyonları 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", ...} }] }
Neler alırsın
Radyo hakkında bildiğimiz her şey için tek bir API.
İstasyonlar ve yayınlar
Ad, ülke, tür ve dile göre ara. Biçimiyle birlikte her yayın adresi ve birbirine benzeyen istasyonlar.
Yayın sağlığı
Yayınları kendimiz kontrol ederiz: çevrimiçi mi değil mi, codec, bit hızı ve 30 günlük çalışma süresi. Uygulamanda artık ölü istasyon yok.
Şimdi çalıyor
Binlerce istasyonun yayınından okunan, şu an çalan şarkı ve öncekiler.
Radyo listeleri
Radyoda en çok çalınan şarkılar ve sanatçılar; ülke ve türe göre, günlük çalınma sayılarıyla.
Radioguide Channels
Bağımsız sanatçıların yeni müzikleriyle kendi kanallarımız: şu an çalan ve sıradaki şarkıların programı.
Senkronize kal
Bir istasyon değiştiğinde, bir yayın kesildiğinde ya da yeni bir şarkı başladığında değişiklik akışı, günlük tam dışa aktarım ve webhook'lar.
Kimler kullanıyor
Radyo uygulamaları
İstasyon listesi tutmadan bir radyo uygulaması yap: arama, logolar, çalışan yayınlar ve şu an çalanlar.
Developer ya da ProOtomobil, TV ve donanım üreticileri
Gösterge panellerinde, Smart TV'lerde, set üstü kutularda ve Wi-Fi radyolarda internet radyosu; her boyutta logolar ve her gün kontrol edilen yayınlarla.
Business ya da veri lisansıMüzik sektörü ve analiz
Radyonun hangi şarkıları ve sanatçıları nerede ve ne sıklıkla çaldığını gör. Plak şirketleri, organizatörler ve pazar araştırması için.
Pro ya da BusinessWeb siteleri ve widget'lar
Kendi sitende yerel istasyonları, bir listeyi ya da şu an çalanı göster.
Free ya da DeveloperPlanlar
Ücretsiz başla. Yayına geçince yükselt; istediğin ay iptal et.
Free
- Günde 1.000 çağrı
- Dakikada 30 çağrı
- Ticari olmayan kullanım
- Bağlantılı "Powered by Radioguide.fm" ibaresi zorunlu
- Logolar ve yayın durumu
- Şimdi çalıyor
- Radyo listeleri
- Çalışma süresi, codec ve bit hızı
- Değişiklik akışı ve webhook'lar
- Günlük tam dışa aktarım
Developer
- Günde 50.000 çağrı
- Dakikada 300 çağrı
- Tek bir uygulamada ya da sitede ticari kullanım
- Logolar ve yayın durumu
- Şimdi çalıyor
- Radyo listeleri
- Çalışma süresi, codec ve bit hızı
- Değişiklik akışı ve webhook'lar
- Günlük tam dışa aktarım
Pro
- Günde 500.000 çağrı
- Dakikada 1.500 çağrı
- Tek bir uygulamada ya da sitede ticari kullanım
- Logolar ve yayın durumu
- Şimdi çalıyor
- Radyo listeleri
- Çalışma süresi, codec ve bit hızı
- Değişiklik akışı ve webhook'lar
- Günlük tam dışa aktarım
Business
- Günde 5.000.000 çağrı
- Dakikada 6.000 çağrı
- Birden fazla uygulamada ticari kullanım
- Logolar ve yayın durumu
- Şimdi çalıyor
- Radyo listeleri
- Çalışma süresi, codec ve bit hızı
- Değişiklik akışı ve webhook'lar
- Günlük tam dışa aktarım
- %99,9 çalışma süresi SLA'sı
Enterprise
- Özel limitler ve veri lisansı
- Birden fazla uygulamada ticari kullanım
- Logolar ve yayın durumu
- Şimdi çalıyor
- Radyo listeleri
- Çalışma süresi, codec ve bit hızı
- Değişiklik akışı ve webhook'lar
- Günlük tam dışa aktarım
- %99,95 çalışma süresi SLA'sı
Fiyatlara KDV dahil değildir. KDV ödeme sırasında eklenir.
Hızlı başlangıç
Ücretsiz anahtar oluştur
Giriş yap, projene bir ad ver ve anahtarı kopyala. Yalnızca bir kez gösterilir.
İlk çağrını yap
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"
Tarayıcıda kullan
Anahtarlar sunucundan çalışır. Bir web sayfasından yapılan çağrılar için portalda alan adını anahtara ekle; başka siteler onu kullanamaz.
const r = await fetch("https://www.radioguide.fm/api/v2/channels", { headers: { "X-Api-Key": "rg_live_..." } });
const { data } = await r.json();Yapay zekâ asistanlarında Radioguide
MCP sunucumuz sayesinde Claude, ChatGPT ve diğer asistanlar istasyon arar, ne çaldığını görür, yayındaki şarkıları bulur ve radyo listelerini okur; istasyon sayfalarına bağlantılarla.
Claude
Claude’da (web veya masaüstü): Ayarlar, Bağlayıcılar, Özel bağlayıcı ekle. Ad: Radioguide. Adres:
https://www.radioguide.fm/mcp
Claude Code:
claude mcp add --transport http radioguide https://www.radioguide.fm/mcp --header "Authorization: Bearer rg_live_..."
API anahtarınla Claude Desktop yapılandırma dosyası (claude_desktop_config.json):
{
"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’de: Ayarlar, Uygulamalar ve bağlayıcılar, Gelişmiş ayarlar: geliştirici modunu aç. Ardından bu adresle ve kimlik doğrulamasız bir bağlayıcı oluştur:
https://www.radioguide.fm/mcp
ChatGPT’de dinle butonlu istasyon kartları görünür (beta).
Actions içeren özel GPT: şemayı bu adresten içe aktar ve kimlik doğrulama olarak API key, Bearer seç:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Diğer MCP istemcileri
Streamable HTTP taşımasını destekleyen her istemci çalışır: JSON-RPC mesajlarını POST ile bu adrese gönder. Örnek:
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"}}}'
Başlık gönderemeyen istemciler anahtarı adrese ekleyebilir: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Bunun için ayrı bir anahtar kullan.
Anahtarsız: ağ başına dakikada 20 ve günde 300 araç çağrısı, yanıt başına en fazla 5 sonuç. API anahtarıyla her araç çağrısı paketinden bir API çağrısı sayılır.
Asistanlar Radioguide.fm’i kaynak olarak belirtmeli ve andıkları istasyon sayfalarına bağlantı vermelidir. Her araç sonucu bağlantıyı ve kaynak bilgisini içerir.
Bir asistan, arama motoru veya müzik hizmeti mi geliştiriyorsun? İstasyon, şu an çalan ve liste verilerimizi lisansla: günlük dışa aktarımlar, değişiklik akışı, yüksek limitler ve kaynak gösterme anlaşması.
- Her gün kontrol ettiğimiz yayınlarla istasyon verileri
- Binlerce istasyondan şu an çalanlar ve radyo listeleri
- Kaynak gösterme: verinin göründüğü her yerde Radioguide.fm’i istasyon sayfasına bağlantıyla kaynak olarak göster
Free planda, verilerin göründüğü her yerde sitemize bağlantı veren "Powered by Radioguide.fm" ibaresini gösterirsen verileri ticari olmayan projelerde kullanabilirsin. Her yanıt bu metni meta.attribution içinde barındırır.
<a href="https://www.radioguide.fm">Powered by Radioguide.fm</a>
API başvuru kılavuzu OpenAPI 3.1 MCP Değişiklik günlüğü Yayın durumu Kullanım koşulları Veri lisansı