Guide

API des auditeurs mensuels Spotify : auditeurs, abonnés, classement mondial et villes principales par artiste

Le nombre affiché sous le nom de chaque artiste dans l’application Spotify — les auditeurs mensuels — n’est pas dans la Web API. L’objet artiste officiel contient au mieux un nombre d’abonnés et un score de popularité de 0 à 100, rien d’autre sur l’audience, et Spotify marque les deux comme dépréciés et les a retirés pour les applications en mode développement créées à partir du 11 février 2026. Un appel ici renvoie les auditeurs, les abonnés, un classement mondial et les cinq villes où l’artiste est le plus écouté.

Par Eduardo Airaudo, mainteneur de l’API · Mis à jour le 22 octobre 2026

Ce que l’objet artiste officiel ne contient pas

GET /v1/artists/{id} sur la Web API de Spotify renvoie followers.total, un entier popularity, des genres, des images et un nom — les trois premiers marqués comme dépréciés, et les abonnés et la popularité retirés pour les applications en mode développement créées à partir du 11 février 2026. Les auditeurs mensuels — le chiffre que Spotify affiche lui-même sur la page de l’artiste et celui que les labels, les managers et les responsables de placement en playlist suivent réellement — n’apparaissent nulle part dans la référence, et aucun scope ne les ajoute.

La popularité est un score relatif et opaque, recalculé par Spotify d’après les écoutes récentes ; on ne peut ni la convertir en auditeurs, ni la comparer d’un mois à l’autre, ni l’expliquer à un client. Les auditeurs mensuels sont un nombre absolu qui bouge avec une sortie, un placement en synchro ou un ajout en playlist, et c’est pour cela que c’est le chiffre que l’on veut.

/artist_overview renvoie ici la page de l’artiste telle que l’application l’affiche, bloc d’audience compris. Le même appel contient la discographie, les artistes similaires et les éléments épinglés : les chiffres d’audience viennent donc avec le contexte nécessaire pour les lire.

Ce qui est renvoyé

Relevé sur la réponse /artist_overview enregistrée pour Arijit Singh (4YRxDV8wJFPHPTeXepOstw), capturée le 2026-10-22. L’enregistrement complet est sur la page de l’endpoint.

stats.monthlyListeners
Le chiffre d’audience de la page de l’artiste : auditeurs distincts sur les 28 derniers jours, sous forme d’entier. 53 500 280 dans l’enregistrement.
stats.followers
Nombre d’abonnés. Spotify l’a retiré de son propre objet artiste pour les applications en mode développement créées à partir du 11 février 2026 ; les applications à quota étendu l’obtiennent toujours. 195 766 074 dans l’enregistrement.
stats.worldRank
La position de l’artiste dans le classement mondial de Spotify par auditeurs — 56 dans l’enregistrement. Absent pour les artistes hors de l’ensemble classé.
stats.topCities.items[]
Cinq lignes de city, region, country et numberOfListeners. L’enregistrement s’ouvre sur Pune, IN avec 4 174 171 auditeurs, puis Delhi, New Delhi, Mumbai et Bengaluru.
profile.name
Nom d’affichage. L’enregistrement contient aussi la biographie, une liste externalLinks (vide pour cet artiste), l’élément épinglé et les propres playlists de l’artiste sous profile, et aucun indicateur de vérification.
discography, relatedContent
Dernière sortie, albums, singles, apparitions et bloc des artistes similaires, dans la même réponse — un appel couvre toute la page de l’artiste.

53 500 280

stats.monthlyListeners

195 766 074

stats.followers

#56

stats.worldRank

Trois chiffres tirés d’un enregistrement, 2026-10-22. Ils servent à rendre la forme concrète, pas à donner des chiffres actuels — appuyez sur Exécuter sur la page de l’endpoint pour ceux d’aujourd’hui.

Un artiste, 10 artistes, ou un classement

/artist_overview_batch accepte jusqu’à 10 identifiants séparés par des virgules et renvoie le même objet par artiste : 10 artistes coûtent donc une requête au lieu de 10.

Selon la spécification, /top_20_by_monthly_listeners est « Wikipedia's list of the most-streamed artists on Spotify: up to 50 rows of {rank, artist, monthlyListeners}, where monthlyListeners is in millions (129.8 means 129,800,000). Not country-specific » et /top_20_by_followers est « Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific ». Aucun des deux n’accepte de paramètre.

La réponse enregistrée des auditeurs, capturée le 2026-10-22, contient 50 lignes de rank, artist et monthlyListeners exprimés en millions — la première ligne indique Bruno Mars à 128,6.

Récupérer les chiffres d’audience d’un artiste

L’identifiant est la chaîne de 22 caractères qui suit /artist/ dans n’importe quelle URL Spotify. Vous n’avez qu’un nom ? /search?q=&type=artists renvoie l’identifiant.

Suivre le nombre dans le temps

Spotify ne publie qu’une valeur actuelle, pas un historique. À vous de construire une série temporelle : appelez /artist_overview à intervalle régulier, enregistrez stats.monthlyListeners avec un horodatage, et calculez les différences entre les lignes. Une tâche quotidienne pour une liste de 25 artistes représente 3 requêtes par lot par jour — 90 requêtes par mois, dans la limite des 1 000 de l’offre gratuite.

Pour que l’API conserve l’historique, /tracking/track?spotifyType=artist&spotifyId= enregistre l’artiste ; ses lignes monthly_listeners_change et followers_change s’accumulent dans /tracking/logs, que vous interrogez. Les webhooks ne couvrent que les changements de playlist. Les deux sont dans la référence sous Tracking ; ce sont des endpoints opérationnels, la démo de ce site ne les exécute donc pas.

Sans code : Spotify Monthly Listeners Scraper (opens in a new tab) on Apify returns monthly listeners, followers, world rank and top cities for any artist. spotify-monthly-listeners (opens in a new tab) on GitHub has daily monthly listeners, followers and world rank for 500 artists, as CSV and JSON history.

Questions

La Web API de Spotify renvoie-t-elle les auditeurs mensuels ?

Non. L’objet artiste de la référence de la Web API liste followers.total, la popularité, les genres, les images et un nom. Les trois premiers sont marqués comme dépréciés, et les abonnés et la popularité ont été retirés pour les applications en mode développement créées à partir du 11 février 2026. Les auditeurs mensuels s’affichent dans les clients de Spotify mais ne font pas partie de l’API documentée, et aucun scope OAuth ne les expose.

Ce nombre est-il à jour ?

Les vues d’ensemble des artistes sont mises en cache environ une heure : une réponse peut donc être en retard d’autant sur le chiffre de l’application Spotify. Ajoutez cache=false pour forcer une récupération à jour ; l’en-tête X-Cache indique comment chaque réponse a été servie. Les boutons Exécuter de ce site passent aussi par le cache propre à la démo : un chiffre peut donc y être plus ancien.

Puis-je obtenir les auditeurs mensuels de nombreux artistes à la fois ?

Oui. GET /artist_overview_batch accepte jusqu’à 10 identifiants d’artistes séparés par des virgules et renvoie le même objet de vue d’ensemble pour chacun : 10 artistes coûtent donc une requête. GET /artists?ids= accepte aussi une liste, mais renvoie l’objet artiste de Spotify : pas d’auditeurs mensuels, et pour beaucoup d’artistes pas de nombre d’abonnés non plus.

worldRank est-il une position mondiale ?

C’est le classement que Spotify affiche lui-même sur la page de l’artiste (« n° 56 dans le monde » dans l’enregistrement utilisé ici). Les artistes hors de l’ensemble classé n’ont pas de champ worldRank : traitez-le donc comme facultatif.

Que sont les villes principales ?

stats.topCities.items liste les cinq villes qui comptent le plus d’auditeurs pour l’artiste, chacune avec city, region, country et numberOfListeners. C’est le même bloc que la page de l’artiste affiche sous « À propos ».

Puis-je obtenir l’historique des auditeurs mensuels d’un artiste ?

Pas auprès de Spotify, qui ne publie que la valeur actuelle. Enregistrez le nombre à intervalle régulier et vous avez l’historique à partir de ce jour ; 3 appels par lot par jour pour 25 artistes coûtent 90 requêtes par mois.

De quel forfait ai-je besoin ?

N’importe lequel. Les endpoints utilisés dans ce guide sont sur chaque forfait, RapidAPI comme portail direct, et les forfaits diffèrent par le volume mensuel. Chaque forfait RapidAPI autorise 5 requêtes par seconde et chaque clé directe en inclut 10. Le forfait gratuit de RapidAPI autorise 1 000 requêtes par mois.

Sources

More guides

What changed in the API and on these pages, and when: What's new.

Obtenez une clé et récupérez votre premier artiste

Les mêmes endpoints sur les trois, à des prix différents. L’offre gratuite de RapidAPI est de 1 000 requêtes par mois — de quoi suivre une liste d’artistes chaque jour.

RapidAPI Apify Portail direct

Pas encore prêt à acheter ? Obtenir une clé d’essai gratuite : 500 requêtes sur 7 jours, sans carte.