Was im Internetradio läuft, jetzt gerade.
Tuneping führt einen Live-Index von Zehntausenden Internetradiosendern und stellt ihn als JSON-API bereit, mit Wiedergabeverlauf und Wunschlisten-Benachrichtigungen. Wir lesen die Titelzeile, die jeder Player anzeigt, und nie das Audio.
Probieren live, gegen den echten Index · 2 req/s ohne Schlüssel
API-Doku lesenLive-StatusGET https://api.tuneping.com/v1/now-playing/search
01 · Was Sie bekommen
Sechs Dinge, eine API
Live-Suche
ohne SchlüsselFragen Sie „Wer spielt gerade Blue Monday?“ und erhalten Sie die Sender, unscharf und unabhängig von Akzenten, mit einer Konfidenzstufe pro Treffer.
GET /v1/now-playing/search
Jetzt läuft für Favoriten
ohne SchlüsselEine Anfrage für einen Batch von Sender-IDs liefert den aktuellen Titel, wann er zuerst gesehen und wann er zuletzt bestätigt wurde.
GET /v1/now-playing?station_ids=…
Wiedergabeverlauf
ab DeveloperWas ein Sender gespielt hat, mit geschätzten Start- und Endzeiten: 7 Tage im Developer-Tarif, 12 Monate ab Pro.
GET /v1/stations/{id}/history
Wunschlisten-Benachrichtigungen
ab DeveloperNennen Sie einen Song oder Interpreten und erfahren Sie sofort, wenn ein Sender ihn spielt. Fragen Sie ihn ab oder streamen Sie ihn über SSE; ab Pro empfangen Sie einen Webhook.
SSE · webhook
Tracks und Interpreten
ohne SchlüsselTitel werden normalisiert und, wo möglich, mit MusicBrainz-Kennungen verknüpft, sodass Sie Wiedergaben pro Track oder Interpret zählen können.
trk_… · art_… · MusicBrainz ids
Senderverzeichnis
ohne SchlüsselZehntausende Sender mit Land, Codec und der Methode, mit der wir ihre Titel lesen, durchsuchbar und filterbar.
GET /v1/stations
02 · So funktioniert es
Wir lesen eine Zeile
Jeder Stream führt einen kleinen Nebenkanal mit dem aktuellen Titel mit, dem Text, den Ihr Player anzeigt. Tuneping liest diesen und sonst nichts.
Verzeichnis
Wir beginnen mit dem öffentlichen, von der Community gepflegten Radio-Browser-Verzeichnis und prüfen jeden Sender einmal, um die günstigste Stelle zu finden, an der sein Titel veröffentlicht wird: den öffentlichen Status-Endpoint des Streaming-Servers oder den Metadatenblock im Stream.
Abfragen, mit Rücksicht
Alle 20 bis 60 Sekunden lesen wir pro Sender einige hundert Byte bis etwa 16 KB und schließen dann die Verbindung. Höchstens zwei gleichzeitige Verbindungen pro Server, robots.txt und Retry-After werden beachtet. Details für Betreiber.
Normalisieren
Titel werden in Interpret und Track aufgeteilt, als Song, Senderkennung, Sendung oder Werbung eingeordnet, mit MusicBrainz abgeglichen, wo der Text das zulässt, und mit einer Startzeit samt ausdrücklich angegebener Unsicherheit versehen.
Ausliefern
Eine schlichte JSON-API mit ETags, Rate-Limit-Headern und Edge-Caching, beschrieben in einer OpenAPI-Datei und der API-Referenz.
Nur Metadaten · alles, was wir von einer Abfrage behalten
StreamTitle='Madonna - Holiday';
Das Audio drumherum wird beim Eintreffen verworfen. Keine Aufnahme, keine Vorschau, kein Fingerprinting, nichts wird weitergeleitet. Was der Abfragedienst tut.
03 · Ehrliche Grenzen
Was es nicht kann
Viele Sender senden keine Titel, nur ihren eigenen Namen oder Slogans. Wir kennzeichnen sie und erfinden keine Daten; die Statusseite zeigt, wie viele Live-Metadaten liefern.
Ein Wechsel, der bei einer Abfrage auffällt, geschah irgendwann im vorherigen Intervall. Jede Wiedergabe enthält start_uncertainty_seconds; rechnen Sie je nach Methode mit ±10 bis 30 s.
Die Erkennung anhand von Sender-Metadaten ist weniger vollständig als Audioerkennung und nie eine zertifizierte Zählung der Wiedergaben. Als Nachweis schreiben Sie „anhand von Sender-Metadaten erkannt“.
Streams ziehen um, verschwinden und wechseln täglich den Besitzer. Ein Sender kann jederzeit widersprechen und verschwindet innerhalb von 24 Stunden aus der API.
Sendernamen werden als Text geliefert; Logos und Artwork gehören nicht zum Dienst.
04 · Tarife
Tarife
Selbstbedienung, jederzeit kündbar. Jährliche Abrechnung kostet das Zehnfache des Monatspreises. Preise inklusive USt., sofern anwendbar; Stripe rechnet in CHF, EUR, USD, GBP oder JPY ab. Business und jährliche Abrechnung: [email protected].
Free
0 €
dauerhaft
- 1.000 Anfragen pro Tag
- 2 req/s, Burst 5
- Live-Suche, Jetzt läuft im Batch (20 Sender), Senderverzeichnis
- Abfragen von Tracks und Interpreten
- 1 API-Schlüssel nach E-Mail-Bestätigung
- Zeigt „Data by Tuneping“ an
Developer
29 € / Monat
oder 290 € / Jahr
- 100.000 Anfragen pro Monat
- 10 req/s, Burst 20
- Jetzt läuft im Batch für bis zu 100 Sender
- 7 Tage Wiedergabeverlauf
- 10 Wunschlisten, abgefragt oder per SSE
- E-Mail-Support innerhalb von 2 Werktagen
- Keine Namensnennung erforderlich
Pro
99 € / Monat
oder 990 € / Jahr
- 1.000.000 Anfragen pro Monat
- 50 req/s, Burst 100
- 12 Monate Wiedergabeverlauf
- 5 Webhook-Endpoints mit Filtern für Sender, Track und Interpret
- 100 Wunschlisten, auch per Webhook zugestellt
- Wiedergabeberichte pro Track und Interpret
- 5 API-Schlüssel, E-Mail-Support innerhalb von 1 Werktag
Business
ab 349 € / Monat
jährliche Rechnung, individuelles Volumen
- Individuelles Anfragevolumen und individuelle Rate
- 12 Monate Verlauf, darüber hinaus Aggregate
- 20 Webhook-Endpoints, ungefilterter Firehose erlaubt
- 1.000 Wunschlisten, 20 SSE-Verbindungen
- CSV- / JSONL-Exporte
- 99,5 % monatliches SLA für Lesezugriffe, fester Ansprechpartner
05 · Betreiber
Betreiben Sie einen Sender?
Möglicherweise sehen Sie TunepingBot/0.1 (+https://tuneping.com/bot) in Ihren Logs. Er liest alle 20 bis 60 Sekunden Ihren öffentlichen Status-Endpoint oder den ersten Metadatenblock Ihres Streams, und nicht mehr. Seine Adressen und drei Opt-out-Wege, die innerhalb von 24 Stunden wirken, stehen auf einer Seite. Fragen: [email protected].