Spotify
Catálogo, listas y reproducción controlada vía Web API y OAuth.
Ver la documentaciónPara qué sirve
Qué problema resuelve
La Web API de Spotify permite buscar temas, álbumes y artistas, leer playlists y, con los scopes adecuados, controlar la reproducción del usuario. Crear una app en el Dashboard es gratis; los límites se calculan por aplicación en una ventana móvil de 30 segundos y se comunican con 429 y Retry-After.
En la práctica
Qué puedes hacer con ella
- Buscar canciones, álbumes o artistas.
- Leer playlists públicas o del usuario autorizado.
- Obtener metadatos de un track (nombre, duración, álbum).
- Usar Client Credentials para catálogo sin usuario.
- Con Authorization Code, actuar en nombre del oyente.
¿Es gratis?
Gratis para desarrolladores (con rate limits)
No hay tarifa por request de la Web API al crear una app. Spotify calcula rate limits por app en una ventana móvil de 30 s; si te pasas, 429. Algunos endpoints tienen límites propios. Hay quota modes de playlists distintos del rate limit.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Abrir Spotify Developer Dashboard
Qué cuenta como una «llamada» aquí
Cada request a api.spotify.com/v1 consume del presupuesto de rate limit de tu app.
No es un plan de créditos de pago: es un freno antiabuso. Client Credentials no accede a datos de usuario; para eso necesitas OAuth con scopes.
Rate limits Spotify
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Límite global de app | Ventana móvil de 30 segundos | Demasiadas llamadas → 429; espera Retry-After. |
| Endpoints especiales | Límites propios | P. ej. subida de imagen de playlist puede diferir del límite global. |
| Playlist quota modes | Distinto del rate limit | Restricciones de desarrollo vs extended quota. |
Coste
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Web API developer app | $0 por request | Desarrolladores con cuenta Spotify. | Dashboard · OAuth · rate limits. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Open source? | No. Spotify es un servicio comercial; la Web API tiene Developer Terms. |
| ¿Uso comercial? | Permitido dentro de los Developer Terms y las políticas de marca/SDK. No redistribuyas audio ni vulneres ToS. |
| ¿Hace falta cuenta? | Sí: cuenta Spotify + app en el Dashboard (client id/secret). |
Cómo empezar
Buscar un tema con Client Credentials.
Necesitas una app en el Developer Dashboard.
Dirección base de las imágenes: https://api.spotify.com/v1
- 01
Paso 1
Crea una app en https://developer.spotify.com/dashboard y copia client id/secret.
- 02
Paso 2
POST https://accounts.spotify.com/api/token con grant_type=client_credentials.
- 03
Paso 3
GET https://api.spotify.com/v1/search?q=karma&type=track con Authorization: Bearer TOKEN
- 04
Paso 4
Si llega 429, espera Retry-After.
- 05
Paso 5
Rate limits: https://developer.spotify.com/documentation/web-api/concepts/rate-limits
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra Spotify Web API. Docs: https://developer.spotify.com/documentation/web-api . Rate limits: https://developer.spotify.com/documentation/web-api/concepts/rate-limits . No inventes client secrets. ¿Client Credentials (catálogo) o Authorization Code (usuario)?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · OAuth
Requiere flujo OAuth: el usuario autoriza tu aplicación antes de leer sus datos.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sin verificar
No consta si permite llamadas desde el navegador; pruébalo antes de montar el cliente.