Guía

API de reproducciones de Spotify: reproducciones totales de cualquier canción, por ID o ISRC

La Web API de Spotify nunca dice cuántas veces se ha reproducido una canción. Lo más cercano es la popularidad, una puntuación de 0 a 100 que su propia referencia describe como basada sobre todo en el total de reproducciones, y que marca como obsoleta. Estos endpoints devuelven el propio recuento: una canción por ID de Spotify o ISRC, o hasta 50 canciones en una sola llamada.

Por Eduardo Airaudo, mantenedor de la API · Actualizado el 22 de octubre de 2026

Lo que deja fuera el objeto de canción oficial

GET /v1/tracks/{id} de la Web API de Spotify devuelve el álbum, los artistas, duration_ms, explicit, external_ids, el nombre, popularity y algunos campos más. Ninguno cuenta reproducciones. La popularidad es lo que más se acerca: la referencia de Spotify la define como un valor de 0 a 100, calculado sobre todo a partir de cuántas reproducciones ha tenido una canción y de lo recientes que son, y la marca como obsoleta. Los cambios de febrero de 2026 de Spotify la eliminaron para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026.

Una puntuación no puede hacer lo que hace un recuento. Es relativa, así que no se suma en un álbum ni en un catálogo, y favorece las reproducciones recientes (la misma referencia dice que las canciones muy reproducidas ahora puntúan más que las muy reproducidas en el pasado), así que no puede decir cuántas veces se ha reproducido una canción en total.

En palabras de la especificación, el grupo Partner de esta API es “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count devuelve el recuento total de una canción, /partner/tracks/count el de hasta 50 canciones a la vez, y /partner/track lo incluye dentro del registro completo de la canción.

Qué devuelve

Campo por campo, tal como los definen los esquemas de respuesta de la especificación. La llamada de una sola canción nombra el recuento streams; la de lotes lo nombra playcount.

Una canción

GET /partner/track/count

streams
El recuento total de reproducciones, como entero (int64). Admite nulo en la especificación, y es 0 para una canción con menos de 1.000 reproducciones.
spotify_track_id
El ID de Spotify de la canción.
isrc
El ISRC de la canción. Admite nulo en la especificación.
result
success o error, con un message breve al lado.

Un lote

GET /partner/tracks/count

tracks[]
Una entrada por cada ID solicitado, en el orden de la solicitud.
tracks[].playcount
Reproducciones totales (int64, admite nulo); 0 para una canción con menos de 1.000.
tracks[].status
ok, not_found o error, con un texto de error cuando es error.
tracks[].name
El nombre de la canción; null cuando no se encontró.
tracks[].artists[]
El id y el name de cada artista.
tracks[].releaseDate
La fecha de lanzamiento del álbum de la canción: YYYY-MM-DD, o con menos precisión.
missing[]
Los IDs solicitados cuyo estado no es ok.

Un 0 significa menos de 1.000, no que nunca se haya reproducido. La especificación dice que Spotify informa 0 para las canciones con menos de 1.000 reproducciones, así que guarda un 0 como “menos de 1.000” y no como un recuento.

Muestra grabada · capturada el 2026-10-22

GET /partner/track/count

6 líneas: el cuerpo grabado completo.

Muestra grabada · capturada el 2026-10-22

GET /partner/tracks/count

18 líneas: el cuerpo grabado completo.

Una canción, o 50 por llamada

  • GET /partner/track/countTrack play count

    Lifetime play count of one track, by Spotify id (spotify_track_id, or its alias id) or by isrc. Spotify reports 0 for tracks with fewer than 1,000 plays. Play counts are cached for 1 hour; for many tracks use /partner/tracks/count.

    Parámetrosspotify_track_id, id, isrc, cache

  • GET /partner/tracks/countTrack play counts (batch)

    Lifetime play counts for up to 50 tracks in one call. Entries come back in request order with status ok, not_found or error; ids without a play count are also listed in missing. Each id is cached for 1 hour.

    Parámetrosids, cache

  • GET /partner/trackPartner track data

    Track with its play count (data.trackUnion.playcount), album, artists and content ratings. Add slim=1 to keep only {id, uri, profile.name, visuals.avatarImage} of each artist (the full payload embeds the first artist's discography and is ~100 KB).

    Parámetrosid, slim, cache

/partner/tracks/count acepta hasta 50 IDs separados por comas y responde en el orden en que los enviaste, así que 50 canciones cuestan una solicitud en lugar de 50.

Obtener reproducciones

Una canción, por ID de Spotify

El ID es la cadena de 22 caracteres que sigue a /track/ en cualquier URL de Spotify. Para buscar una canción por su ISRC, envía isrc= en lugar de id=.

Hasta 50 canciones en una llamada

Lee el status de cada entrada antes que su recuento. Las entradas vuelven en el orden de los IDs; la que no tiene recuento viene marcada como not_found o error en su lugar, y se vuelve a listar en missing.

Reproducciones sin código

Si los recuentos son para una hoja de cálculo y no para tu propio código, dos Actors de Apify del mismo mantenedor los devuelven como un dataset. Una ejecución necesita una cuenta de Apify y ninguna clave de API: pegas enlaces y descargas JSON o CSV.

Ambos facturan por resultado, a los precios listados el : $0.001 por fila en el plan gratuito de Apify, hasta $0.0006 desde Gold. Cuándo compensa una ejecución frente a una clave, y cuándo no, está en la guía del scraper.

Un historial ya guardado: spotify-most-streamed-songs (opens in a new tab) on GitHub has daily play counts and daily streams for 1,000 of the most-streamed songs, as CSV and JSON history.

Úsalo desde un asistente de IA (MCP): pídele a Claude, Cursor o VS Code las reproducciones de una canción, y la herramienta get_track_play_count del servidor MCP de Spotify devuelve las reproducciones totales desde esta API. Configura el servidor MCP.

Preguntas

¿La Web API de Spotify devuelve reproducciones?

No. El objeto de canción de la referencia de la Web API no tiene ningún campo de reproducciones. Su campo más cercano, popularidad, es una puntuación de 0 a 100 que Spotify calcula sobre todo a partir del total de reproducciones y de lo recientes que son; la referencia la marca como obsoleta, y los cambios de febrero de 2026 de Spotify la eliminaron para las apps en modo de desarrollo creadas a partir del 11 de febrero de 2026.

¿Por qué una canción muestra 0 reproducciones?

Porque tiene menos de 1.000. La especificación dice que Spotify informa 0 para las canciones con menos de 1.000 reproducciones, así que un 0 significa menos de 1.000, no que nunca se haya reproducido.

¿Puedo obtener las reproducciones de muchas canciones a la vez?

Sí. GET /partner/tracks/count acepta hasta 50 IDs de canción separados por comas y responde en el orden de la solicitud, cada entrada con un estado de ok, not_found o error; los IDs sin recuento también se listan en missing. 50 canciones cuestan una solicitud en lugar de 50.

¿Puedo buscar una canción por ISRC?

Sí. GET /partner/track/count acepta isrc en lugar de un ID de Spotify, así que un catálogo organizado por ISRC no necesita buscar antes el ID.

¿Qué antigüedad tiene el número?

Las reproducciones se guardan en caché durante una hora, así que un recuento suele tener como mucho esa antigüedad. Un valor de X-Cache que empiece por STALE o FALLBACK significa que se sirvió una copia más antigua porque la consulta en vivo fue lenta o falló; X-Cache-Stale-Age da su antigüedad en segundos. Añade cache=false para obtener uno nuevo. 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 reproducciones sin escribir código?

Sí, en Apify: una ejecución necesita una cuenta de Apify y ninguna clave de API. El Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) acepta enlaces de canciones, álbumes, artistas o playlists y devuelve una fila por canción con su recuento de reproducciones; el Spotify Scraper (eduair94/spotify-scraper) tiene 5 categorías de reproducciones entre sus 61. Ambos facturan por resultado.

¿Qué plan necesito?

Cualquiera. Los dos endpoints de reproducciones 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

More guides

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

Consigue una clave y obtén tu primer recuento de reproducciones

Los dos endpoints de reproducciones están en todos los planes, tanto de RapidAPI como del portal directo; en Apify, los dos Actors de arriba devuelven los mismos recuentos como filas de dataset, facturadas por resultado. El plan gratuito de RapidAPI es de 1000 solicitudes al mes: con hasta 50 canciones por llamada, hasta 50.000 recuentos de reproducciones.

RapidAPI Apify Portal directo

¿Aún no quieres comprar? Consigue una clave de prueba gratis: 500 solicitudes durante 7 días, sin tarjeta.