API de Spotify
Busca y consulta artistas, pistas, álbumes, playlists, podcasts y otros objetos públicos de Spotify. La URL y el tipo devuelto conservan la identidad de cada recurso.
Oyentes mensuales y seguidores son lecturas puntuales; no representan ingresos ni historial. El catálogo puede variar por región y ninguna acción reproduce o descarga audio.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Spotify, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Consultar un objeto de Spotify por URLprofile | Consulta la url de un objeto de Spotify y devuelve su identidad, tipo, fecha, sello, artistas y pistas cuando corresponden. | $1.39 por 1.000 solicitudes | Normal |
Buscar contenido en Spotifysearch | Busca en Spotify mediante keyword y content_type, conservando el tipo de pista, álbum, artista, playlist o programa. | $1.39 por 1.000 solicitudes | Normal |
Consultar un artista de Spotifyartist | Abre la url de un artista y recoge biografía, géneros, oyentes mensuales, seguidores y ranking visibles. | $1.39 por 1.000 solicitudes | Normal |
Consultar los datos de una pistatrack | Consulta la url de una pista y devuelve la relación con álbum, sello y clasificación de contenido cuando aparecen. | $1.39 por 1.000 solicitudes | Normal |
Consultar un álbum de Spotifyalbum | Abre la url de un álbum y conserva artistas, fecha, sello, copyright, portada y lista de pistas. | $1.39 por 1.000 solicitudes | Normal |
Consultar una playlist de Spotifyplaylist | Consulta la url de una playlist y devuelve propietario, descripción, seguidores y pistas visibles. | $1.39 por 1.000 solicitudes | Normal |
Buscar programas y episodiospodcast | Busca programas o episodios con keyword y el content_type admitido. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Spotify?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
profileConsultar un objeto de Spotify por URL Consulta la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform |
searchBuscar contenido en Spotify Busca en Spotify mediante | keyword | content_type | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
artistConsultar un artista de Spotify Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform |
trackConsultar los datos de una pista Consulta la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · artists · album_name · duration_ms · play_count · track_number · disc_number · is_explicit · release_date · preview_url · image_url · added_at · platform · album_id · album_type · label · content_rating |
albumConsultar un álbum de Spotify Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform |
playlistConsultar una playlist de Spotify Consulta la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform |
podcastBuscar programas y episodios Busca programas o episodios con | keyword | content_type | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
¿Qué significan los parámetros de Spotify profile?
Consulta la url de un objeto de Spotify y devuelve su identidad, tipo, fecha, sello, artistas y pistas cuando corresponden. No reproduce audio ni accede a una cuenta personal autenticada.
urlObligatorio- Para
artist,track,albumoplaylist, usa el enlace correspondiente deopen.spotify.com. También puedes enviarspotify:tipo:IDo solo el ID en el parámetrourl. El tipo de objeto lo determina laaction; no mezcles tipos. La acciónprofile(obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.Spotify: URL, URI e identificador de recurso — Spotify diferencia URL, URI, ID e identificador de usuario. Cada acción de EveryInfra acepta la entrada que documenta; que dos cadenas identifiquen el mismo recurso en Spotify no las vuelve intercambiables aquí. · Consultada
¿Qué significan los parámetros de Spotify search?
Busca en Spotify mediante keyword y content_type, conservando el tipo de pista, álbum, artista, playlist o programa. El resultado no garantiza catálogo idéntico por región ni popularidad histórica.
keywordObligatorio- Término de búsqueda de música para
search. El tipo de contenido se selecciona concontent_type. La acciónpodcastbusca programas de pódcast por defecto, no es una consulta de detalles de episodios. content_typeOpcional- Para
search, usatracks(pistas),artists(artistas),albums(álbumes) oplaylists(listas de reproducción). La acciónpodcasttiene sus propios valores:podcasts_shows(programas, predeterminado) opodcast_episodes_individual_episodes(episodios individuales). Los valores de una acción no sirven en la otra.Valores permitidos:albumsartistsplayliststracks
¿Qué significan los parámetros de Spotify artist?
Abre la url de un artista y recoge biografía, géneros, oyentes mensuales, seguidores y ranking visibles. Son señales públicas puntuales, no ingresos ni una serie histórica.
urlObligatorio- Para
artist,track,albumoplaylist, usa el enlace correspondiente deopen.spotify.com. También puedes enviarspotify:tipo:IDo solo el ID en el parámetrourl. El tipo de objeto lo determina laaction; no mezcles tipos. La acciónprofile(obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.Spotify: diferencias de criterio entre oyentes mensuales y oyentes activos mensuales — Spotify define a los oyentes mensuales como aquellos de los últimos 28 días, incluyendo fuentes activas y recomendaciones algorítmicas; los oyentes activos mensuales son solo el subconjunto que escucha de forma activa. El campo `monthly_listener_count` de esta página no debe interpretarse como dicho subconjunto, ni como el número de reproducciones o de seguidores. · Consultada
¿Qué significan los parámetros de Spotify track?
Consulta la url de una pista y devuelve la relación con álbum, sello y clasificación de contenido cuando aparecen. No entrega el archivo de audio ni confirma derechos territoriales.
urlObligatorio- Para
artist,track,albumoplaylist, usa el enlace correspondiente deopen.spotify.com. También puedes enviarspotify:tipo:IDo solo el ID en el parámetrourl. El tipo de objeto lo determina laaction; no mezcles tipos. La acciónprofile(obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.Spotify: un ID aislado no indica el tipo de recurso — La documentación oficial aclara que un ID de Spotify por sí solo no especifica el tipo de recurso, ya que este lo proporciona el contexto de la llamada, mientras que el URI sí incluye dicha información. Es imprescindible que la acción, la ruta del enlace y el objeto del ID coincidan; no se puede depender de la misma cadena de caracteres para convertir automáticamente entre distintos recursos. · ConsultadaSpotify: límites de uso entre la pista, el álbum al que pertenece y el contenido — La documentación oficial de pistas distingue entre los objetos `track` y `album`, y detalla por separado las restricciones de atribución, descarga y uso en modelos. Esta consulta de metadatos no otorga permisos para descargar el audio completo ni para entrenar modelos; los campos adicionales oficiales y el parámetro `market` tampoco forman parte automática del contrato de EveryInfra. · Consultada
¿Qué significan los parámetros de Spotify album?
Abre la url de un álbum y conserva artistas, fecha, sello, copyright, portada y lista de pistas. No reproduce el contenido ni garantiza que todas las ediciones regionales sean iguales.
urlObligatorio- Para
artist,track,albumoplaylist, usa el enlace correspondiente deopen.spotify.com. También puedes enviarspotify:tipo:IDo solo el ID en el parámetrourl. El tipo de objeto lo determina laaction; no mezcles tipos. La acciónprofile(obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.Spotify: un ID aislado no indica el tipo de recurso — La documentación oficial aclara que un ID de Spotify por sí solo no especifica el tipo de recurso, ya que este lo proporciona el contexto de la llamada, mientras que el URI sí incluye dicha información. Es imprescindible que la acción, la ruta del enlace y el objeto del ID coincidan; no se puede depender de la misma cadena de caracteres para convertir automáticamente entre distintos recursos. · Consultada
¿Qué significan los parámetros de Spotify playlist?
Consulta la url de una playlist y devuelve propietario, descripción, seguidores y pistas visibles. No modifica la lista, no revela seguidores nominales ni asegura que cada tema siga disponible.
urlObligatorio- Para
artist,track,albumoplaylist, usa el enlace correspondiente deopen.spotify.com. También puedes enviarspotify:tipo:IDo solo el ID en el parámetrourl. El tipo de objeto lo determina laaction; no mezcles tipos. La acciónprofile(obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.Spotify: un ID aislado no indica el tipo de recurso — La documentación oficial aclara que un ID de Spotify por sí solo no especifica el tipo de recurso, ya que este lo proporciona el contexto de la llamada, mientras que el URI sí incluye dicha información. Es imprescindible que la acción, la ruta del enlace y el objeto del ID coincidan; no se puede depender de la misma cadena de caracteres para convertir automáticamente entre distintos recursos. · Consultada
¿Qué significan los parámetros de Spotify podcast?
Busca programas o episodios con keyword y el content_type admitido. Conserva el tipo devuelto para no confundir show y episodio; no descarga audio ni accede a suscripciones privadas.
keywordObligatorio- Término de búsqueda de música para
search. El tipo de contenido se selecciona concontent_type. La acciónpodcastbusca programas de pódcast por defecto, no es una consulta de detalles de episodios. content_typeOpcional- Para
search, usatracks(pistas),artists(artistas),albums(álbumes) oplaylists(listas de reproducción). La acciónpodcasttiene sus propios valores:podcasts_shows(programas, predeterminado) opodcast_episodes_individual_episodes(episodios individuales). Los valores de una acción no sirven en la otra.Valores permitidos:podcast_episodes_individual_episodespodcasts_showsSpotify: un programa de pódcast y un episodio son objetos diferentes — La plataforma utiliza la página del programa para organizar sus episodios disponibles, y explica por separado cómo seguir un programa y cómo guardar un episodio. Aquí solo se expone la relación jerárquica; no se replican las capacidades del cliente de Spotify para reproducir, descargar sin conexión o suscribirse a contenido de pago. · Consultada
Cómo usar la API de Spotify
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"spotify","action":"profile","params":{"url":"<url>"}}'
Preguntas sobre la API de Spotify
¿Cómo llamo a la API de Spotify?
Envía POST /api/v1/social con platform igual a spotify, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Spotify?
Devuelve JSON estructurado. Por ejemplo, el esquema de profile incluye name, type, release_date y label. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Spotify?
Spotify diferencia URL, URI, ID e identificador de usuario. Cada acción de EveryInfra acepta la entrada que documenta; que dos cadenas identifiquen el mismo recurso en Spotify no las vuelve intercambiables aquí.
¿Qué parámetros son obligatorios?
Depende de la acción. profile requiere url; search requiere keyword; artist requiere url; consulta las demás acciones en la lista de funciones.
¿Las acciones de Spotify responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.