Apa yang sedang diputar di radio internet, saat ini.
Tuneping menyimpan indeks langsung dari puluhan ribu stasiun radio internet dan menyajikannya sebagai JSON API, lengkap dengan riwayat pemutaran dan notifikasi wishlist. Kami membaca baris judul yang ditampilkan setiap pemutar, tidak pernah audionya.
Coba langsung, terhadap indeks sungguhan · 2 req/s tanpa key
Baca dokumentasi APIStatus langsungGET https://api.tuneping.com/v1/now-playing/search
01 · Apa yang Anda dapatkan
Enam hal, satu API
Pencarian langsung
tanpa keyTanyakan “siapa yang sedang memutar Blue Monday saat ini?” dan dapatkan daftar stasiunnya, dengan pencocokan fuzzy yang tidak peka aksen, serta tingkat keyakinan untuk setiap kecocokan.
GET /v1/now-playing/search
Sedang diputar untuk favorit
tanpa keySatu permintaan untuk sekumpulan id stasiun mengembalikan judul saat ini, kapan judul itu pertama kali terlihat, dan kapan terakhir dikonfirmasi.
GET /v1/now-playing?station_ids=…
Riwayat pemutaran
developer +Apa yang diputar sebuah stasiun, dengan perkiraan waktu mulai dan selesai: 7 hari pada Developer, 12 bulan pada Pro ke atas.
GET /v1/stations/{id}/history
Notifikasi wishlist
developer +Sebutkan sebuah lagu atau artis dan ketahui saat sebuah stasiun mulai memutarnya. Lakukan polling atau terima melalui stream SSE; mulai Pro, terima juga webhook.
SSE · webhook
Lagu dan artis
tanpa keyJudul dinormalisasi dan, jika memungkinkan, ditautkan ke identifier MusicBrainz sehingga Anda dapat menghitung pemutaran per lagu atau per artis.
trk_… · art_… · MusicBrainz ids
Direktori stasiun
tanpa keyPuluhan ribu stasiun dengan negara, codec, dan metode yang kami gunakan untuk membaca judulnya, dapat dicari dan difilter.
GET /v1/stations
02 · Cara kerja
Kami membaca satu baris
Setiap stream membawa kanal samping kecil berisi judul saat ini, teks yang ditampilkan pemutar Anda. Tuneping membaca itu dan tidak ada yang lain.
Direktori
Kami mulai dari direktori publik Radio Browser yang dikelola komunitas dan memeriksa setiap stasiun sekali untuk menemukan tempat termurah judulnya dipublikasikan: endpoint status publik milik server streaming atau blok metadata di dalam stream.
Polling, dengan sopan
Setiap 20 hingga 60 detik kami membaca beberapa ratus byte hingga sekitar 16 KB per stasiun, lalu menutup koneksi. Paling banyak dua koneksi per server sekaligus, robots.txt dan Retry-After dipatuhi. Detail untuk operator.
Normalisasi
Judul dipisah menjadi artis dan lagu, diklasifikasikan sebagai lagu, ident, program, atau iklan, dicocokkan dengan MusicBrainz jika teksnya memungkinkan, dan diberi waktu mulai dengan ketidakpastian yang dinyatakan secara eksplisit.
Penyajian
JSON API sederhana dengan ETag, header rate limit, dan caching di edge, dijelaskan dalam file OpenAPI dan referensi API.
Hanya metadata · semua yang kami simpan dari satu polling
StreamTitle='Madonna - Holiday';
Audio di sekitarnya dibuang begitu tiba. Tanpa rekaman, tanpa pratinjau, tanpa fingerprinting, tidak ada yang diteruskan. Apa yang dilakukan poller.
03 · Batasan yang jujur
Apa yang tidak dapat dilakukannya
Banyak stasiun tidak mengirim judul, hanya nama mereka sendiri, atau slogan. Kami menandainya dan tidak mengarang data; halaman status menunjukkan berapa banyak yang mengirim metadata langsung.
Perubahan yang terlihat saat polling terjadi di suatu titik dalam interval sebelumnya. Setiap pemutaran membawa start_uncertainty_seconds; perkirakan ±10 hingga 30 s tergantung metodenya.
Deteksi dari metadata stasiun kurang lengkap dibanding pengenalan audio dan tidak pernah menjadi hitungan pemutaran yang tersertifikasi. Sebagai bukti, sebutkan “terdeteksi dari metadata stasiun”.
Stream berpindah, mati, dan berganti pemilik setiap hari. Stasiun dapat memilih keluar (opt-out) kapan saja dan dihapus dari API dalam 24 jam.
Nama stasiun dikembalikan sebagai teks; logo dan artwork bukan bagian dari layanan.
04 · Paket
Paket
Layanan mandiri, batalkan kapan saja. Tagihan tahunan sebesar sepuluh kali tagihan bulanan. Harga sudah termasuk PPN jika berlaku; Stripe menagih dalam CHF, EUR, USD, GBP, atau JPY. Business dan tagihan tahunan: [email protected].
Free
€0
selamanya
- 1.000 permintaan per hari
- 2 req/s, burst 5
- Pencarian langsung, batch now-playing (20 stasiun), direktori stasiun
- Pencarian lagu dan artis
- 1 API key setelah verifikasi e-mail
- Menampilkan “Data by Tuneping”
Developer
€29 / bulan
atau €290 / tahun
- 100.000 permintaan per bulan
- 10 req/s, burst 20
- Batch now-playing hingga 100 stasiun
- Riwayat pemutaran 7 hari
- 10 wishlist, melalui polling atau SSE
- Dukungan e-mail dalam 2 hari kerja
- Tidak wajib mencantumkan atribusi
Pro
€99 / bulan
atau €990 / tahun
- 1.000.000 permintaan per bulan
- 50 req/s, burst 100
- Riwayat pemutaran 12 bulan
- 5 endpoint webhook dengan filter stasiun, lagu, dan artis
- 100 wishlist, juga dikirim melalui webhook
- Laporan pemutaran per lagu dan artis
- 5 API key, dukungan e-mail dalam 1 hari kerja
Business
mulai €349 / bulan
tagihan tahunan, volume khusus
- Volume dan laju permintaan khusus
- Riwayat 12 bulan plus agregat setelahnya
- 20 endpoint webhook, firehose tanpa filter diizinkan
- 1.000 wishlist, 20 koneksi SSE
- Ekspor CSV / JSONL
- SLA bulanan 99,5 % untuk pembacaan, kontak khusus
05 · Operator
Mengelola stasiun?
Anda mungkin melihat TunepingBot/0.1 (+https://tuneping.com/bot) di log Anda. Bot ini membaca endpoint status publik Anda atau blok metadata pertama dari stream Anda setiap 20 hingga 60 detik, dan tidak lebih. Alamatnya, serta tiga cara opt-out yang berlaku dalam 24 jam, ada di satu halaman. Pertanyaan: [email protected].