網路電臺現在正在播什麼。
Tuneping 為數萬個網路電臺維護一份即時索引，並以 JSON API 提供，附播放紀錄與願望清單通知。我們讀取每個播放器都會顯示的那一行標題，從不讀取音訊。
01 · 你會得到什麼
六項功能，一個 API
即時搜尋
免金鑰問「現在哪裡在播 Blue Monday？」就能拿到電臺清單。支援模糊比對、不分重音符號，每筆結果都附信心等級。
GET /v1/now-playing/search
收藏電臺的正在播放
免金鑰一次請求帶入一批電臺 id，即回傳目前的標題、首次出現的時間，以及最後確認的時間。
GET /v1/now-playing?station_ids=…
播放紀錄
Developer 以上電臺播過哪些歌，附估計的開始與結束時間：Developer 方案保留 7 天，Pro 以上保留 12 個月。
GET /v1/stations/{id}/history
願望清單通知
Developer 以上指定一首歌或一位藝人，電臺一開始播放就能得知。可以輪詢或透過 SSE 串流接收；Pro 以上方案也可接收 webhook。
SSE · webhook
曲目與藝人
免金鑰標題會經過正規化，並盡可能連結到 MusicBrainz 識別碼，方便你依曲目或藝人統計播放次數。
trk_… · art_… · MusicBrainz ids
電臺目錄
免金鑰數萬個電臺，附國家、編碼格式，以及我們讀取其曲目標題的方式，可搜尋、可篩選。
GET /v1/stations
02 · 運作方式
我們只讀一行
每個串流都帶有一條小小的附屬通道，裡面是目前的標題，也就是你的播放器顯示的那行文字。Tuneping 只讀這個，其他一概不讀。
目錄
我們從社群維護的公開 Radio Browser 目錄出發，對每個電臺探測一次，找出讀取標題成本最低的位置：串流伺服器的公開狀態端點，或串流內的中繼資料區塊。
有禮貌地輪詢
每 20 到 60 秒，我們對每個電臺讀取幾百位元組到約 16 KB，然後關閉連線。同一伺服器同時最多兩條連線，遵守 robots.txt 與 Retry-After。給電臺營運者的說明。
正規化
標題會拆成藝人與曲名，分類為歌曲、電臺識別、節目或廣告；文字足夠時與 MusicBrainz 比對，並給出附明確誤差範圍的開始時間。
提供服務
一個單純的 JSON API，支援 ETag、速率限制標頭與邊緣快取，規格寫在 OpenAPI 檔案和 API 參考文件中。
只有中繼資料 · 一次輪詢中我們保留的全部內容
StreamTitle='Madonna - Holiday';
周圍的音訊邊收邊丟棄。不錄音、不試聽、不做音訊指紋、不轉送任何內容。輪詢程式做了什麼。
03 · 誠實面對限制
它做不到的事
許多電臺不傳送標題，只傳自己的臺名或標語。我們會標記這些電臺，不會捏造資料；狀態頁面會顯示有多少電臺提供即時中繼資料。
在某次輪詢看到的變化，其實發生在前一個間隔內的某個時間點。每筆播放都帶有 start_uncertainty_seconds；依讀取方式不同，誤差約 ±10 到 30 秒。
從電臺中繼資料偵測，完整度不如音訊辨識，也絕不是經認證的播放次數。作為證據引用時，請註明「根據電臺中繼資料偵測」。
串流每天都在搬家、停播、易手。電臺隨時可以選擇退出，24 小時內就會從 API 中移除。
電臺名稱以文字回傳；標誌與封面圖片不在服務範圍內。
04 · 方案
方案
自助申請，隨時可取消。年繳價格為月繳的十倍。價格在適用時已含增值稅；Stripe 以 CHF、EUR、USD、GBP 或 JPY 計費。Business 方案與年繳：請寫信至 [email protected]。
Free
€0
永久
- 每天 1,000 次請求
- 2 req/s，突發 5
- 即時搜尋、批次查詢正在播放（20 個電臺）、電臺目錄
- 曲目與藝人查詢
- 電子郵件驗證後取得 1 把 API 金鑰
- 顯示「Data by Tuneping」
Developer
€29 / 月
或 €290 / 年
- 每月 100,000 次請求
- 10 req/s，突發 20
- 批次查詢正在播放，最多 100 個電臺
- 7 天播放紀錄
- 10 個願望清單，透過輪詢或 SSE
- 電子郵件支援，2 個工作天內回覆
- 不需標示出處
Pro
€99 / 月
或 €990 / 年
- 每月 1,000,000 次請求
- 50 req/s，突發 100
- 12 個月播放紀錄
- 5 個 webhook 端點，可依電臺、曲目與藝人篩選
- 100 個願望清單，也可透過 webhook 送達
- 依曲目與藝人的播放報告
- 5 把 API 金鑰，電子郵件支援 1 個工作天內回覆
Business
€349 起 / 月
按年開立發票，用量另議
- 自訂請求量與速率
- 12 個月播放紀錄，更早的資料提供彙總
- 20 個 webhook 端點，可接收未篩選的完整事件流
- 1,000 個願望清單，20 條 SSE 連線
- CSV / JSONL 匯出
- 讀取服務每月 99.5 % SLA，專屬聯絡窗口
05 · 電臺營運者
你經營電臺嗎？
你可能會在日誌中看到 TunepingBot/0.1 (+https://tuneping.com/bot)。它每 20 到 60 秒讀取一次你的公開狀態端點，或你串流的第一個中繼資料區塊，僅此而已。它的 IP 位址，以及三種在 24 小時內生效的退出方式，都整理在同一頁。有問題請寫信至 [email protected]。