Aller au contenu
RadioNowPlaying

API de métadonnées radio

Le titre en cours de n'importe quelle radio, via une seule API.

Artiste, titre et pochette, normalisés et à jour, quelle que soit la source : flux ICY, API d'éditeurs ou hébergeurs. Une requête, une réponse JSON propre.

Obtenir une clé gratuite Voir la doc

Offre gratuite sans carte bancaire · Clé en 1 minute · Hébergé en Europe

En direct

Pour les développeurs

Une requête. Une réponse claire.

Identifiez une station par son slug ou son UUID et récupérez le titre en cours en quelques millisecondes, servi depuis le cache.

  • Format stable et documenté (OpenAPI), erreurs en problem+json
  • Statut explicite : ok, talk, stale ou unavailable
  • Clé dans l'en-tête Authorization ou X-API-Key, CORS ouvert

Requête

curl "https://api.radio-nowplaying-api.sacha-cohen.fr/v1/stations/radio-paradise/now-playing" \
  -H "Authorization: Bearer rnp_live_YOUR_KEY"

Réponse

{
  "station": {
    "id": "01a10c37-9fc9-70eb-9836-cd8cedeef9ab",
    "slug": "radio-paradise",
    "name": "Radio Paradise"
  },
  "now_playing": {
    "artist": "Joe Jackson",
    "title": "Fools in Love (Live)",
    "cover_url": "https://img.radioparadise.com/covers/l/8125.jpg",
    "started_at": "2026-10-05T13:21:50Z",
    "duration_s": 274,
    "source": "http_json",
    "confidence": 90,
    "fetched_at": "2026-10-05T13:22:48Z"
  },
  "status": "ok"
}

Comment ça marche

Toutes les sources, une seule sortie.

Chaque station a sa chaîne de sources ordonnée. Nous interrogeons la meilleure, basculons sur la suivante en cas d'échec, puis nettoyons et normalisons le résultat.

Flux ICY

Icecast, SHOUTcast

API d'éditeurs

Groupes radio, sites officiels

Hébergeurs

Plateformes de diffusion

Normalisation

  • · Chaîne de repli par station
  • · Nettoyage artiste / titre
  • · Filtrage pubs et jingles
  • · Pochettes et horodatage
GET /v1/now-playing → Une seule API

Une couverture qui grandit chaque jour.

Stations actives
0
Pays
0
Taux de titrage (24 h)
—
Titres détectés (24 h)
0

Chiffres calculés en direct par l'API et mis à jour toutes les 5 minutes.

Fonctionnalités

Tout ce qu'il faut pour afficher la musique en direct.

  • Requêtes groupées

    Jusqu'à 100 stations en un seul appel, comptées comme une seule requête.

  • Historique

    Les derniers titres diffusés par station, paginés par curseur.

  • Temps réel (SSE)

    Recevez chaque changement de titre en Server-Sent Events, sans polling.

  • Webhooks signés

    Un POST signé HMAC-SHA256 vers votre serveur à chaque nouveau titre.

  • Quotas transparents

    Limites visibles dans chaque réponse (en-têtes) et dans votre tableau de bord.

  • Clés maîtrisées

    Restrictions par domaine ou IP, rotation avec période de grâce, révocation immédiate.

Tarifs

Commencez gratuitement, évoluez sans friction.

Pas de carte bancaire pour l'offre gratuite. Changez de plan à tout moment.

  • Free

    Pour tester et les petits projets

    0 €/ mois

    • 1 000 requêtes / jour
    • 10 requêtes / seconde
    • Batch jusqu'à 100 stations
    • Historique des 20 derniers titres
    Commencer gratuitement
  • Populaire

    Pro

    Pour les applications en production

    19 €/ mois

    • 100 000 requêtes / jour
    • Temps réel (SSE)
    • Webhooks signés
    • Historique des 200 derniers titres
    Passer à Pro

  • Business

    Volumes importants et besoins spécifiques

    Sur devis

    • Quotas sur mesure
    • Temps réel et webhooks illimités
    • Support prioritaire
    • Sources dédiées
    Nous contacter

FAQ

Questions fréquentes

Que renvoie exactement l'API ?

Pour chaque station : l'artiste, le titre, la pochette quand elle est disponible, l'heure de début, la source utilisée et un statut (ok, talk, stale, unavailable).

Quelles radios sont couvertes ?

Des radios du monde entier, ajoutées en continu. Le nombre exact de stations et de pays est affiché ci-dessus et via l'endpoint de recherche.

Les données sont-elles vraiment en direct ?

Les titres sont rafraîchis en continu pour les stations demandées et servis depuis le cache. Si une donnée est trop ancienne, le statut l'indique (stale) plutôt que de vous tromper.

Diffusez-vous de l'audio ?

Non. Nous ne distribuons que des métadonnées (artiste, titre, pochette), jamais de flux audio.

D'où viennent les données ?

De sources publiques : métadonnées ICY des flux, API publiques des éditeurs et des hébergeurs. Chaque source est revue et son statut juridique suivi.

Que comprend l'offre gratuite ?

Un quota journalier de requêtes, le batch et l'historique récent. Les limites exactes de chaque plan sont détaillées dans la section Tarifs.

Comment recevoir les changements en temps réel ?

Avec les plans compatibles, ouvrez un flux Server-Sent Events sur une station, ou déclarez un webhook signé qui sera appelé à chaque nouveau titre.

Ma radio n'est pas encore couverte, que faire ?

Écrivez-nous : nous ajoutons régulièrement de nouvelles stations et sources.

Affichez la musique en direct dès aujourd'hui.

Créez un compte, générez votre clé et faites votre premier appel en moins d'une minute.

Obtenir une clé gratuiteVoir la doc