Guía
API de oyentes mensuales de Spotify: oyentes, seguidores, ranking mundial y ciudades principales por artista
La cifra que aparece bajo el nombre de cada artista en la app de Spotify, los oyentes mensuales, no está en la Web API. El objeto de artista oficial lleva como mucho un número de seguidores y una puntuación de popularidad de 0 a 100, y nada más sobre la audiencia; Spotify marca ambos como obsoletos y los eliminó para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026. Una llamada aquí devuelve los oyentes, los seguidores, un ranking mundial y las cinco ciudades donde más se escucha al artista.
Por Eduardo Airaudo, mantenedor de la API · Actualizado el 22 de octubre de 2026
Lo que deja fuera el objeto de artista oficial
GET /v1/artists/{id} de la Web API de Spotify devuelve followers.total, un entero popularity, géneros, imágenes y un nombre; los tres primeros están marcados como obsoletos, y los seguidores y la popularidad se eliminaron para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026. Los oyentes mensuales, la cifra que el propio Spotify pone en la página del artista y la que sellos, managers y promotores de playlists siguen de verdad, no aparecen en ninguna parte de la referencia, y ningún scope los añade.
La popularidad es una puntuación relativa y opaca que Spotify recalcula a partir de las reproducciones recientes; no se puede convertir en oyentes, comparar entre meses ni explicar a un cliente. Los oyentes mensuales son un recuento absoluto que se mueve con un lanzamiento, una sincronización o la inclusión en una playlist, y por eso es el número que la gente quiere.
/artist_overview devuelve aquí la página del artista tal como la renderiza la app, con el bloque de audiencia incluido. La misma llamada trae la discografía, los artistas relacionados y los elementos fijados, así que las cifras de audiencia llegan con el contexto necesario para interpretarlas.
Qué devuelve
Leído de la respuesta grabada de /artist_overview para Arijit Singh (4YRxDV8wJFPHPTeXepOstw), capturada el 2026-10-22. La grabación completa está en la página del propio endpoint.
- stats.monthlyListeners
- La cifra de audiencia de la página del artista: oyentes distintos de los últimos 28 días, como entero. 53.500.280 en la grabación.
- stats.followers
- Número de seguidores. Spotify lo eliminó de su propio objeto de artista para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026; las apps con cuota ampliada lo siguen recibiendo. 195.766.074 en la grabación.
- stats.worldRank
- La posición del artista en el ranking global de Spotify por oyentes: 56 en la grabación. Ausente para los artistas fuera del conjunto clasificado.
- stats.topCities.items[]
- Cinco filas de city, region, country y numberOfListeners. La grabación abre con Pune, IN con 4.174.171 oyentes, y sigue con Delhi, New Delhi, Mumbai y Bengaluru.
- profile.name
- Nombre visible. La grabación también incluye la biografía, una lista externalLinks (vacía para este artista), el elemento fijado y las playlists propias del artista bajo profile, y ningún indicador de verificación.
- discography, relatedContent
- Último lanzamiento, álbumes, sencillos, aparece en y el bloque de artistas relacionados, en la misma respuesta: una llamada cubre toda la página del artista.
53.500.280
stats.monthlyListeners
195.766.074
stats.followers
#56
stats.worldRank
Tres cifras de una grabación, 2026-10-22. Se muestran para concretar la forma de la respuesta, no como cifras actuales: pulsa Ejecutar en la página del endpoint para ver las de hoy.
Un artista, 10 artistas o un ranking
- Artist overviewGET /artist_overview
- Artist overview (batch)GET /artist_overview_batch
- Most-listened artists (monthly listeners)GET /top_20_by_monthly_listeners
- Most-followed artistsGET /top_20_by_followers
/artist_overview_batch acepta hasta 10 IDs separados por comas y devuelve el mismo objeto por artista, así que 10 artistas cuestan una solicitud en lugar de 10.
En palabras de la especificación, /top_20_by_monthly_listeners es “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” y /top_20_by_followers es “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Ninguno acepta parámetros.
La respuesta grabada de oyentes, capturada el 2026-10-22, contiene 50 filas de rank, artist y monthlyListeners expresados en millones; la primera fila muestra a Bruno Mars con 128,6.
Obtener las cifras de audiencia de un artista
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
El ID es la cadena de 22 caracteres que sigue a /artist/ en cualquier URL de Spotify. ¿Tienes un nombre en su lugar? /search?q=&type=artists devuelve el ID.
Seguir la cifra a lo largo del tiempo
Spotify publica un único valor actual, no un historial. La serie temporal te toca construirla a ti: llama a /artist_overview de forma programada, guarda stats.monthlyListeners con una marca de tiempo y calcula la diferencia entre filas. Un trabajo diario para una lista de 25 artistas son 3 solicitudes por lotes al día: 90 solicitudes al mes, dentro de las 1000 del plan gratuito.
Para que la API guarde el historial, /tracking/track?spotifyType=artist&spotifyId= registra al artista; sus filas de monthly_listeners_change y followers_change se acumulan en /tracking/logs, que consultas tú. Los webhooks cubren solo los cambios de playlists. Ambos están en la referencia bajo Tracking; son endpoints operativos, así que la demo de este sitio no los ejecuta.
Sin código: 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.
Preguntas
¿La Web API de Spotify devuelve oyentes mensuales?
No. El objeto de artista de la referencia de la Web API incluye followers.total, popularidad, géneros, imágenes y un nombre. Los tres primeros están marcados como obsoletos, y los seguidores y la popularidad se eliminaron para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026. Los oyentes mensuales se muestran en los clientes de Spotify, pero no forman parte de la API documentada y ningún scope de OAuth los expone.
¿Qué antigüedad tiene la cifra?
Los resúmenes de artista se guardan en caché durante aproximadamente una hora, así que una respuesta puede ir hasta ese tiempo por detrás de la cifra de la app de Spotify. Añade cache=false para forzar una consulta nueva; la cabecera X-Cache indica cómo se sirvió cada respuesta. Los botones Ejecutar de este sitio pasan además por la caché propia de la demo, así que ahí una cifra puede ser más antigua.
¿Puedo obtener los oyentes mensuales de muchos artistas a la vez?
Sí. GET /artist_overview_batch acepta hasta 10 IDs de artista separados por comas y devuelve el mismo objeto de resumen para cada uno, así que 10 artistas cuestan una solicitud. GET /artists?ids= también acepta una lista, pero devuelve el objeto de artista del propio Spotify: sin oyentes mensuales y, para muchos artistas, tampoco número de seguidores.
¿worldRank es una posición global?
Es el ranking que el propio Spotify muestra en la página del artista (“N.º 56 en el mundo” en la grabación usada aquí). Los artistas fuera del conjunto clasificado no tienen el campo worldRank, así que trátalo como opcional.
¿Qué son las ciudades principales?
stats.topCities.items lista las cinco ciudades con más oyentes del artista, cada una con city, region, country y numberOfListeners. Es el mismo bloque que muestra la página del artista en Acerca de.
¿Puedo obtener el historial de oyentes mensuales de un artista?
No de Spotify, que publica solo el valor actual. Guarda la cifra de forma programada y tendrás el historial desde ese día; 3 llamadas diarias por lotes para 25 artistas cuestan 90 solicitudes al mes.
¿Qué plan necesito?
Cualquiera. Los endpoints que usa esta guía están en todos los planes, tanto de RapidAPI como del portal directo, y los planes se diferencian por el volumen mensual. Todos los planes de RapidAPI permiten 5 solicitudes por segundo y todas las claves directas incluyen 10. El plan gratuito de RapidAPI permite 1000 solicitudes al mes.
Fuentes
- Get Artist — referencia de la Web API de Spotify — el objeto de artista oficial: seguidores, popularidad y géneros marcados como obsoletos; sin campo de oyentes mensuales.
- Cambios de febrero de 2026 — referencia de Spotify for Developers — seguidores y popularidad de los artistas eliminados para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026.
- GET /artist_overview en este sitio — la respuesta grabada de la que lee esta página, completa y con su fecha de captura.
- GET /top_20_by_monthly_listeners en este sitio — el ranking de la plataforma, con su propia grabación.
More guides
- Spotify Web API alternativeEndpoint-by-endpoint mapping from the official API, including everything Spotify removed on 27 November 2024.
- Spotify API without OAuthOne header instead of the client-credentials flow — and the things a key genuinely cannot do.
- Spotify lyrics APIWhy the Web API has no lyrics endpoint, and how to get line-synced lyrics as JSON, LRC or SRT.
- Spotify charts APIDaily Top 200 and viral charts as JSON: rank movement, stream counts, credits, and how to backfill.
- Spotify play count APILifetime streams for any track, by Spotify id or ISRC, one or a batch per call — and why a 0 means under 1,000.
- Spotify audio features API after the 2024 deprecationTempo, energy, danceability, recommendations and related artists after Spotify removed them for new apps.
- Spotify API rate limitsThe official 30-second rolling window, what each plan here allows per second and per month, and how to stay under it.
- Spotify scraper on ApifyPlay counts, charts, lyrics and credits as a scheduled run with no API key — and when an API key is the better tool.
- Spotify MCP serverPlay counts, monthly listeners and charts inside Claude, Cursor or VS Code: an open-source MCP server that runs with your own key.
What changed in the API and on these pages, and when: What's new.
Consigue una clave y obtén tu primer artista
Los mismos endpoints en las tres opciones, con precios distintos. El plan gratuito de RapidAPI es de 1000 solicitudes al mes, suficiente para seguir una lista de artistas a diario.
¿Aún no quieres comprar? Consigue una clave de prueba gratis: 500 solicitudes durante 7 días, sin tarjeta.