Spotify
Busca música, gestiona listas de reproducción, controla la reproducción y accede a tu biblioteca
sp
Instrucciones de uso
Integra Spotify en tu flujo de trabajo. Busca canciones, álbumes, artistas y listas de reproducción. Gestiona listas de reproducción, accede a tu biblioteca, controla la reproducción, explora podcasts y audiolibros.
Herramientas
spotify_search
Busca canciones, álbumes, artistas o listas de reproducción en Spotify. Devuelve resultados coincidentes basados en la consulta.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | Sí | Consulta de búsqueda (p. ej., "Bohemian Rhapsody", "artist:Queen", "genre:rock") |
type | string | No | Tipo de resultados: track, album, artist, playlist, o separados por comas (p. ej., "track,artist") |
limit | number | No | Número máximo de resultados a devolver (1-50) |
offset | number | No | Índice del primer resultado a devolver para paginación |
market | string | No | Código de país ISO 3166-1 alpha-2 para filtrar resultados (p. ej., "US", "GB") |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Lista de canciones coincidentes |
spotify_get_track
Obtén información detallada sobre una canción específica en Spotify mediante su ID.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackId | string | Sí | El ID de Spotify de la canción |
market | string | No | Código de país ISO 3166-1 alpha-2 para disponibilidad de la canción |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de pista de Spotify |
name | string | Nombre de la pista |
artists | array | Lista de artistas |
album | object | Información del álbum |
duration_ms | number | Duración de la pista en milisegundos |
explicit | boolean | Si la pista tiene contenido explícito |
popularity | number | Puntuación de popularidad (0-100) |
preview_url | string | URL para vista previa de 30 segundos |
external_url | string | URL de Spotify |
uri | string | URI de Spotify para la pista |
spotify_get_tracks
Obtén información detallada sobre múltiples pistas en Spotify por sus IDs (hasta 50).
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | Lista de IDs de pistas de Spotify separadas por comas (máx. 50) |
market | string | No | Código de país ISO 3166-1 alpha-2 para disponibilidad de pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Lista de pistas |
spotify_get_album
Obtén información detallada sobre un álbum en Spotify por su ID, incluyendo el listado de pistas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
albumId | string | Sí | El ID de Spotify del álbum |
market | string | No | Código de país ISO 3166-1 alpha-2 para disponibilidad de pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del álbum de Spotify |
name | string | Nombre del álbum |
artists | array | Lista de artistas |
album_type | string | Tipo de álbum (álbum, sencillo, compilación) |
total_tracks | number | Número total de pistas |
release_date | string | Fecha de lanzamiento |
label | string | Sello discográfico |
popularity | number | Puntuación de popularidad (0-100) |
genres | array | Lista de géneros |
image_url | string | URL de la imagen de portada del álbum |
tracks | array | Lista de pistas del álbum |
external_url | string | URL de Spotify |
spotify_get_albums
Obtener detalles de múltiples álbumes por sus IDs.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbumes separados por comas (máx. 20) |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
albums | json | Lista de álbumes |
spotify_get_album_tracks
Obtener las pistas de un álbum.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
albumId | string | Sí | El ID del álbum de Spotify |
limit | number | No | Número de pistas a devolver (1-50) |
offset | number | No | Índice de la primera pista a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | json | Lista de pistas |
total | number | Número total de pistas |
next | string | URL para la siguiente página |
spotify_get_saved_albums
Obtener el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de álbumes a devolver (1-50) |
offset | number | No | Índice del primer álbum a devolver |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
albums | json | Lista de álbumes guardados |
total | number | Total de álbumes guardados |
next | string | URL para la siguiente página |
spotify_save_albums
Guardar álbumes para el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbumes separados por comas (máx. 20) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los álbumes fueron guardados |
spotify_remove_saved_albums
Eliminar álbumes del usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbumes separados por comas (máx. 20) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si los álbumes fueron eliminados |
spotify_check_saved_albums
Comprobar si los álbumes están guardados en la biblioteca.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbumes separados por comas (máximo 20) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada álbum |
spotify_get_artist
Obtener información detallada sobre un artista en Spotify mediante su ID.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistId | string | Sí | El ID de Spotify del artista |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del artista en Spotify |
name | string | Nombre del artista |
genres | array | Lista de géneros asociados con el artista |
popularity | number | Puntuación de popularidad (0-100) |
followers | number | Número de seguidores |
image_url | string | URL de la imagen del artista |
external_url | string | URL de Spotify |
spotify_get_artists
Obtener detalles de múltiples artistas mediante sus IDs.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistIds | string | Sí | IDs de artistas separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
artists | json | Lista de artistas |
spotify_get_artist_albums
Obtener álbumes de un artista en Spotify. Puede filtrar por tipo de álbum.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistId | string | Sí | El ID de Spotify del artista |
include_groups | string | No | Filtrar por tipo de álbum: album, single, appears_on, compilation (separados por comas) |
limit | number | No | Número máximo de álbumes a devolver (1-50) |
offset | number | No | Índice del primer álbum a devolver |
market | string | No | Código de país ISO 3166-1 alpha-2 |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
albums | array | Artista |
spotify_get_artist_top_tracks
Obtener las 10 canciones más populares de un artista en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistId | string | Sí | El ID de Spotify del artista |
market | string | No | Código de país ISO 3166-1 alpha-2 (obligatorio para este endpoint) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Artista |
spotify_follow_artists
Seguir a uno o más artistas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistIds | string | Sí | IDs de artistas separados por comas para seguir (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los artistas fueron seguidos con éxito |
spotify_unfollow_artists
Dejar de seguir a uno o más artistas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistIds | string | Sí | IDs de artistas separados por comas para dejar de seguir (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si se dejó de seguir a los artistas con éxito |
spotify_get_followed_artists
Obtener el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de artistas a devolver (1-50) |
after | string | No | Cursor para paginación (último ID de artista de la solicitud anterior) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
artists | json | Lista de artistas seguidos |
total | number | Número total de artistas seguidos |
next | string | Cursor para la siguiente página |
spotify_check_following
Comprobar si el usuario sigue a artistas o usuarios.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | string | Sí | Tipo a comprobar: "artist" o "user" |
ids | string | Sí | IDs de artistas o usuarios separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada ID |
spotify_get_show
Obtener detalles de un podcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showId | string | Sí | El ID del show de Spotify |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del show |
name | string | Nombre del show |
description | string | Descripción del show |
publisher | string | Nombre del editor |
total_episodes | number | Total de episodios |
explicit | boolean | Contiene contenido explícito |
languages | json | Idiomas |
image_url | string | URL de la imagen de portada |
external_url | string | URL de Spotify |
spotify_get_shows
Obtener detalles de múltiples podcasts.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showIds | string | Sí | IDs de shows separados por comas (máx. 50) |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
shows | json | Lista de shows |
spotify_get_show_episodes
Obtener episodios de un programa de podcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showId | string | Sí | El ID del programa de Spotify |
limit | number | No | Número de episodios a devolver (1-50) |
offset | number | No | Índice del primer episodio a devolver |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
episodes | json | Lista de episodios |
total | number | Total de episodios |
next | string | URL para la siguiente página |
spotify_get_saved_shows
Obtener el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de programas a devolver (1-50) |
offset | number | No | Índice del primer programa a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
shows | json | Lista de programas guardados |
total | number | Total de programas guardados |
next | string | URL para la siguiente página |
spotify_save_shows
Guardar programas de podcast para el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showIds | string | Sí | IDs de programas separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los programas fueron guardados |
spotify_remove_saved_shows
Eliminar programas de podcast del usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showIds | string | Sí | IDs de programas separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los programas fueron eliminados |
spotify_check_saved_shows
Comprobar si los programas están guardados en la biblioteca.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showIds | string | Sí | IDs de programas separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada programa |
spotify_get_episode
Obtener detalles de un episodio de podcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeId | string | Sí | El ID del episodio de Spotify |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del episodio |
name | string | Nombre del episodio |
description | string | Descripción del episodio |
duration_ms | number | Duración en ms |
release_date | string | Fecha de lanzamiento |
explicit | boolean | Contiene contenido explícito |
show | json | Información del programa principal |
image_url | string | URL de la imagen de portada |
external_url | string | URL de Spotify |
spotify_get_episodes
Obtener detalles de múltiples episodios de podcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeIds | string | Sí | IDs de episodios separados por comas (máx. 50) |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
episodes | json | Lista de episodios |
spotify_get_saved_episodes
Obtener el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de episodios a devolver (1-50) |
offset | number | No | Índice del primer episodio a devolver |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
episodes | json | Lista de episodios guardados |
total | number | Total de episodios guardados |
next | string | URL para la siguiente página |
spotify_save_episodes
Guardar episodios de podcast para el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeIds | string | Sí | IDs de episodios separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los episodios fueron guardados |
spotify_remove_saved_episodes
Eliminar episodios de podcast del usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeIds | string | Sí | IDs de episodios separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si los episodios fueron eliminados |
spotify_check_saved_episodes
Comprobar si los episodios están guardados en la biblioteca.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeIds | string | Sí | IDs de episodios separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada episodio |
spotify_get_audiobook
Obtener detalles de un audiolibro.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookId | string | Sí | El ID del audiolibro de Spotify |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del audiolibro |
name | string | Nombre del audiolibro |
authors | json | Autores |
narrators | json | Narradores |
publisher | string | Editorial |
description | string | Descripción |
total_chapters | number | Total de capítulos |
languages | json | Idiomas |
image_url | string | URL de la imagen de portada |
external_url | string | URL de Spotify |
spotify_get_audiobooks
Obtener detalles de múltiples audiolibros.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookIds | string | Sí | IDs de audiolibros separados por comas (máx. 50) |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
audiobooks | json | Lista de audiolibros |
spotify_get_audiobook_chapters
Obtener capítulos de un audiolibro.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookId | string | Sí | El ID del audiolibro de Spotify |
limit | number | No | Número de capítulos a devolver (1-50) |
offset | number | No | Índice del primer capítulo a devolver |
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
chapters | json | Lista de capítulos |
total | number | Total de capítulos |
next | string | URL para la siguiente página |
spotify_get_saved_audiobooks
Obtener el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de audiolibros a devolver (1-50) |
offset | number | No | Índice del primer audiolibro a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
audiobooks | json | Lista de audiolibros guardados |
total | number | Total de audiolibros guardados |
next | string | URL para la siguiente página |
spotify_save_audiobooks
Guardar audiolibros para el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookIds | string | Sí | IDs de audiolibros separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los audiolibros fueron guardados |
spotify_remove_saved_audiobooks
Eliminar audiolibros del usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookIds | string | Sí | IDs de audiolibros separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los audiolibros fueron eliminados |
spotify_check_saved_audiobooks
Comprobar si los audiolibros están guardados en la biblioteca.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookIds | string | Sí | IDs de audiolibros separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada audiolibro |
spotify_get_playlist
Obtener información detallada sobre una lista de reproducción en Spotify por su ID.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de Spotify de la lista de reproducción |
market | string | No | Código de país ISO 3166-1 alpha-2 para la disponibilidad de pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de la lista de reproducción de Spotify |
name | string | Nombre de la lista de reproducción |
description | string | Descripción de la lista de reproducción |
public | boolean | Si la lista de reproducción es pública |
collaborative | boolean | Si la lista de reproducción es colaborativa |
owner | object | Información del propietario de la lista de reproducción |
image_url | string | URL de la imagen de portada de la lista de reproducción |
total_tracks | number | Número total de pistas |
snapshot_id | string | ID de instantánea de la lista de reproducción para control de versiones |
external_url | string | URL de Spotify |
spotify_get_playlist_tracks
Obtener las pistas de una lista de reproducción de Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de Spotify de la lista de reproducción |
limit | number | No | Número máximo de pistas a devolver (1-100) |
offset | number | No | Índice de la primera pista a devolver |
market | string | No | Código de país ISO 3166-1 alpha-2 para la disponibilidad de pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Lista de pistas en la lista de reproducción |
spotify_get_playlist_cover
Obtener una lista de reproducción
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
images | json | Lista de imágenes de portada |
spotify_get_user_playlists
Obtener el usuario actual
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número máximo de listas de reproducción a devolver (1-50) |
offset | number | No | Índice de la primera lista de reproducción a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
playlists | array | Usuario |
spotify_create_playlist
Crear una nueva lista de reproducción para el usuario actual en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | string | Sí | Nombre para la nueva lista de reproducción |
description | string | No | Descripción para la lista de reproducción |
public | boolean | No | Si la lista de reproducción debe ser pública |
collaborative | boolean | No | Si la lista de reproducción debe ser colaborativa (requiere que public sea false) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de la lista de reproducción de Spotify |
name | string | Nombre de la lista de reproducción |
description | string | Descripción de la lista de reproducción |
public | boolean | Si la lista de reproducción es pública |
collaborative | boolean | Si es colaborativa |
snapshot_id | string | ID de instantánea de la lista de reproducción |
external_url | string | URL de Spotify |
spotify_update_playlist
Actualizar una lista de reproducción
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
name | string | No | Nuevo nombre para la lista de reproducción |
description | string | No | Nueva descripción para la lista de reproducción |
public | boolean | No | Si la lista de reproducción debe ser pública |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si la actualización tuvo éxito |
spotify_add_playlist_cover
Subir una imagen de portada personalizada para una lista de reproducción. La imagen debe ser JPEG y pesar menos de 256KB.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
imageBase64 | string | Sí | Imagen JPEG codificada en Base64 (máx. 256KB) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si la subida tuvo éxito |
spotify_add_tracks_to_playlist
Añadir una o más pistas a una lista de reproducción de Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de Spotify de la lista de reproducción |
uris | string | Sí | URIs de Spotify separadas por comas (p. ej., "spotify:track:xxx,spotify:track:yyy") |
position | number | No | Posición para insertar pistas (base 0). Si se omite, las pistas se añaden al final. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
snapshot_id | string | Nuevo ID de instantánea de la lista de reproducción después de la modificación |
spotify_remove_tracks_from_playlist
Eliminar una o más pistas de una lista de reproducción de Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de Spotify de la lista de reproducción |
uris | string | Sí | URIs de Spotify separadas por comas para eliminar (p. ej., "spotify:track:xxx,spotify:track:yyy") |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
snapshot_id | string | Nuevo ID de instantánea de la lista de reproducción después de la modificación |
spotify_reorder_playlist_items
Mover pistas a una posición diferente en una lista de reproducción.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
range_start | number | Sí | Índice inicial de los elementos a reordenar |
insert_before | number | Sí | Índice donde insertar los elementos |
range_length | number | No | Número de elementos a reordenar |
snapshot_id | string | No | ID de instantánea de la lista de reproducción para control de concurrencia |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
snapshot_id | string | Nuevo ID de instantánea de la lista de reproducción |
spotify_replace_playlist_items
Reemplazar todos los elementos en una lista de reproducción con nuevas pistas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
uris | string | Sí | URIs de Spotify separados por comas (máximo 100) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
snapshot_id | string | Nuevo ID de instantánea de la lista de reproducción |
spotify_follow_playlist
Seguir (guardar) una lista de reproducción.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
public | boolean | No | Si la lista de reproducción estará en listas de reproducción públicas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si el seguimiento tuvo éxito |
spotify_unfollow_playlist
Dejar de seguir (eliminar) una lista de reproducción.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si dejar de seguir tuvo éxito |
spotify_check_playlist_followers
Comprobar si los usuarios siguen una lista de reproducción.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
userIds | string | Sí | IDs de usuario separados por comas para verificar (máximo 5) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada usuario |
spotify_get_current_user
Obtener el usuario actual
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de usuario de Spotify |
display_name | string | Nombre visible |
email | string | Dirección de correo electrónico |
country | string | Código de país |
product | string | Nivel de suscripción (gratuito, premium) |
followers | number | Número de seguidores |
image_url | string | URL de imagen de perfil |
external_url | string | URL del perfil de Spotify |
spotify_get_user_profile
Obtener un usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
userId | string | Sí | El ID de usuario de Spotify |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de usuario |
display_name | string | Nombre visible |
followers | number | Número de seguidores |
image_url | string | URL de imagen de perfil |
external_url | string | URL de Spotify |
spotify_get_top_tracks
Obtener el usuario actual
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
time_range | string | No | Rango de tiempo: short_term (~4 semanas), medium_term (~6 meses), long_term (años) |
limit | number | No | Número de pistas a devolver (1-50) |
offset | number | No | Índice de la primera pista a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Usuario |
spotify_get_top_artists
Obtener el usuario actual
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
time_range | string | No | Rango de tiempo: short_term (~4 semanas), medium_term (~6 meses), long_term (años) |
limit | number | No | Número de artistas a devolver (1-50) |
offset | number | No | Índice del primer artista a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
artists | array | Usuario |
spotify_get_saved_tracks
Obtener el usuario actual
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de pistas a devolver (1-50) |
offset | number | No | Índice de la primera pista a devolver |
market | string | No | Código de país ISO 3166-1 alpha-2 |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Usuario |
spotify_save_tracks
Guardar pistas para el usuario actual
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | IDs de pistas de Spotify separados por comas para guardar (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si las pistas se guardaron correctamente |
spotify_remove_saved_tracks
Eliminar pistas del usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | IDs de pistas separados por comas para eliminar (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si las pistas se eliminaron correctamente |
spotify_check_saved_tracks
Comprobar si una o más pistas están guardadas en el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | IDs de pistas separados por comas para comprobar (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de IDs de pistas con estado de guardado |
all_saved | boolean | Si todas las pistas están guardadas |
none_saved | boolean | Si ninguna pista está guardada |
spotify_get_recently_played
Obtener el usuario
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
limit | number | No | Número de pistas a devolver (1-50) |
after | number | No | Marca de tiempo Unix en milisegundos. Devuelve elementos después de este cursor. |
before | number | No | Marca de tiempo Unix en milisegundos. Devuelve elementos antes de este cursor. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
items | array | Pistas reproducidas recientemente |
spotify_get_new_releases
Obtener una lista de nuevos lanzamientos de álbumes destacados en Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
country | string | No | Código de país ISO 3166-1 alpha-2 (p. ej., "US", "GB") |
limit | number | No | Número de lanzamientos a devolver (1-50) |
offset | number | No | Índice del primer lanzamiento a devolver |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
albums | json | Lista de nuevos lanzamientos |
total | number | Número total de nuevos lanzamientos |
next | string | URL para la siguiente página |
spotify_get_categories
Obtener una lista de categorías de navegación utilizadas para etiquetar elementos en Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
country | string | No | Código de país ISO 3166-1 alpha-2 (p. ej., "US", "GB") |
locale | string | No | Código de localización (p. ej., "en_US", "es_MX") |
limit | number | No | Número de categorías a devolver (1-50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
categories | json | Lista de categorías de navegación |
total | number | Número total de categorías |
spotify_get_markets
Obtener la lista de mercados donde Spotify está disponible.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
markets | json | Lista de códigos de país ISO |
spotify_get_playback_state
Obtener el estado actual de reproducción incluyendo dispositivo, pista y progreso.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
market | string | No | Código de país ISO 3166-1 alpha-2 |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
is_playing | boolean | Si la reproducción está activa |
device | object | Información del dispositivo activo |
progress_ms | number | Progreso en milisegundos |
currently_playing_type | string | Tipo de contenido en reproducción |
shuffle_state | boolean | Si el modo aleatorio está activado |
repeat_state | string | Modo de repetición (off, track, context) |
track | object | Pista en reproducción actual |
spotify_get_currently_playing
Obtener el usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
is_playing | boolean | Si la reproducción está activa |
progress_ms | number | Posición actual en la pista (ms) |
track | json | Pista reproduciéndose actualmente |
spotify_get_devices
Obtener el usuario
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
devices | array | Dispositivos de reproducción disponibles |
spotify_get_queue
Obtener el usuario
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
currently_playing | json | Pista reproduciéndose actualmente |
queue | json | Próximas pistas en la cola |
spotify_play
Iniciar o reanudar la reproducción en Spotify. Puede reproducir pistas, álbumes o listas de reproducción específicas.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
device_id | string | No | ID del dispositivo para reproducir. Si no se proporciona, reproduce en el dispositivo activo. |
context_uri | string | No | URI de Spotify del álbum, artista o lista de reproducción a reproducir (p. ej., "spotify:album:xxx") |
uris | string | No | URIs de pistas separadas por comas para reproducir (p. ej., "spotify:track:xxx,spotify:track:yyy") |
offset | number | No | Posición en el contexto para comenzar a reproducir (índice basado en 0) |
position_ms | number | No | Posición en la pista para comenzar (en milisegundos) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la reproducción comenzó correctamente |
spotify_pause
Pausar la reproducción en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
device_id | string | No | ID del dispositivo para pausar. Si no se proporciona, pausa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la reproducción fue pausada |
spotify_skip_next
Saltar a la siguiente pista en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
device_id | string | No | ID del dispositivo. Si no se proporciona, usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el salto fue exitoso |
spotify_skip_previous
Saltar a la pista anterior en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
device_id | string | No | ID del dispositivo. Si no se proporciona, usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el salto fue exitoso |
spotify_seek
Buscar una posición en la pista que se está reproduciendo actualmente.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
position_ms | number | Sí | Posición en milisegundos a la que desplazarse |
device_id | string | No | ID del dispositivo objetivo |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el desplazamiento fue exitoso |
spotify_add_to_queue
Añadir una pista al usuario
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
uri | string | Sí | URI de Spotify de la pista a añadir (p. ej., "spotify:track:xxx") |
device_id | string | No | ID del dispositivo. Si no se proporciona, usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la pista fue añadida a la cola |
spotify_set_volume
Establecer el volumen de reproducción en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
volume_percent | number | Sí | Nivel de volumen (0 a 100) |
device_id | string | No | ID del dispositivo. Si no se proporciona, usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el volumen fue establecido |
spotify_set_repeat
Establecer el modo de repetición para la reproducción.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
state | string | Sí | Modo de repetición: "off", "track", o "context" |
device_id | string | No | ID del dispositivo objetivo |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el modo de repetición se estableció correctamente |
spotify_set_shuffle
Activar o desactivar la reproducción aleatoria.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
state | boolean | Sí | true para activar la reproducción aleatoria, false para desactivarla |
device_id | string | No | ID del dispositivo objetivo |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la reproducción aleatoria se estableció correctamente |
spotify_transfer_playback
Transferir la reproducción a un dispositivo diferente.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
device_id | string | Sí | ID del dispositivo al que transferir la reproducción |
play | boolean | No | Indica si se debe iniciar la reproducción en el nuevo dispositivo |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la transferencia fue exitosa |
Notas
- Categoría:
tools - Tipo:
spotify