Spotify
Busca música, gestiona listas de reproducción, controla la reproducción y accede a tu biblioteca
Configuración
Búsqueda
Operación
Buscar
Cuenta de Spotify*
Connect spotify...
Consulta de búsqueda*
p. ej., "Bohemian Rhapsody", "artist:Queen"
Tipo de búsqueda
Canciones
Límite
Número de resultados (1-50, predeterminado: 20)
Buscar (
spotify_search)Busca pistas, álbumes, artistas o listas de reproducción en Spotify. Devuelve los resultados que coinciden con 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 que se devolverán (1-50) |
offset | number | No | Índice del primer resultado que se devolverá para la paginación |
market | string | No | Código de país ISO 3166-1 alpha-2 para filtrar los resultados (p. ej., "US", "GB") |
Salida
| Parameter | Type | Description |
|---|---|---|
tracks | array | Lista de pistas coincidentes |
artists | array | Lista de artistas coincidentes |
albums | array | Lista de álbumes coincidentes |
playlists | array | Lista de listas de reproducción coincidentes |
Obtener pista
Operación
Obtener pista
Cuenta de Spotify*
Connect spotify...
ID de pista*
ID de pista de Spotify
Obtener canción (
spotify_get_track)Obtiene información detallada sobre una canción específica de Spotify por 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 la 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 | Indica si la pista tiene contenido explícito |
popularity | number | Puntuación de popularidad (0-100) |
preview_url | string | URL de la vista previa de 30 segundos |
external_url | string | URL de Spotify |
uri | string | URI de Spotify de la pista |
Obtener varias canciones
Operación
Obtener varias pistas
Cuenta de Spotify*
Connect spotify...
IDs de pistas*
IDs de pistas separados por comas
Obtener varias pistas (
spotify_get_tracks)Obtén información detallada sobre varias pistas de Spotify por sus IDs (hasta 50).
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | Lista de IDs de pistas de Spotify separados por comas (máx. 50) |
market | string | No | Código de país ISO 3166-1 alpha-2 para la disponibilidad de la pista |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Lista de canciones |
Obtener álbum
Operación
Obtener álbum
Cuenta de Spotify*
Connect spotify...
ID del álbum*
ID del álbum de Spotify
Obtener álbum (
spotify_get_album)Obtén información detallada sobre un álbum en Spotify por su ID, incluida la lista 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 la disponibilidad de pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | cadena | ID de álbum de Spotify |
name | cadena | Nombre del álbum |
artists | array | Lista de artistas |
album_type | cadena | Tipo de álbum (álbum, sencillo, recopilación) |
total_tracks | número | Número total de pistas |
release_date | cadena | Fecha de lanzamiento |
label | cadena | Sello discográfico |
popularity | número | Puntuación de popularidad (0-100) |
genres | array | Lista de géneros |
image_url | cadena | URL de la imagen de portada del álbum |
tracks | array | Lista de pistas del álbum |
external_url | cadena | URL de Spotify |
Obtener varios álbumes
Operación
Obtener varios álbumes
Cuenta de Spotify*
Connect spotify...
IDs de álbum*
IDs de álbum separados por comas
Obtener varios álbumes (
spotify_get_albums)Obtener detalles de varios álbumes por sus IDs.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbum 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 |
Obtener canciones del álbum
Operación
Obtener pistas del álbum
Cuenta de Spotify*
Connect spotify...
ID de álbum*
ID de álbum de Spotify
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener pistas del álbum (
spotify_get_album_tracks)Obtiene 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 canciones |
total | number | Número total de canciones |
next | string | URL de la página siguiente |
Obtener álbumes guardados
Operación
Obtener álbumes guardados
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener álbumes guardados (
spotify_get_saved_albums)Obtén los álbumes guardados del usuario.
Entrada
| Parámetro | Tipo | Requerido | 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 del mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
albums | json | Lista de álbumes guardados |
total | number | Total de álbumes guardados |
next | string | URL de la página siguiente |
Guardar álbumes
Operación
Guardar álbumes
Cuenta de Spotify*
Connect spotify...
IDs de álbumes*
IDs de álbumes separados por comas
Guardar álbumes (
spotify_save_albums)Guardar álbumes en la biblioteca 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 | booleano | Indica si se guardaron los álbumes |
Eliminar álbumes guardados
Operación
Eliminar álbumes guardados
Cuenta de Spotify*
Connect spotify...
ID de álbumes*
ID de álbumes separados por comas
Eliminar álbumes guardados (
spotify_remove_saved_albums)Eliminar álbumes de la biblioteca del usuario.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbumes separados por comas (máx. 20) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Si se eliminaron álbumes |
Comprobar álbumes guardados
Operación
Comprobar álbumes guardados
Cuenta de Spotify*
Connect spotify...
IDs de álbumes*
IDs de álbumes separados por comas
Comprobar álbumes guardados (
spotify_check_saved_albums)Comprobar si los álbumes están guardados en la biblioteca.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
albumIds | string | Sí | IDs de álbumes separados por comas (máx. 20) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada álbum |
Obtener artista
Operación
Obtener artista
Cuenta de Spotify*
Connect spotify...
ID de artista*
ID de artista de Spotify
Obtener artista (
spotify_get_artist)Obtén información detallada sobre un artista de Spotify mediante su ID.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistId | string | Sí | El ID del artista en Spotify |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de artista de Spotify |
name | string | Nombre del artista |
genres | array | Lista de géneros asociados al 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 |
Obtener varios artistas
Operación
Obtener varios artistas
Cuenta de Spotify*
Connect spotify...
IDs de artistas*
IDs de artistas separados por comas
Obtener varios artistas (
spotify_get_artists)Obtén los detalles de varios artistas por sus IDs.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistIds | string | Sí | IDs de artistas separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
artists | json | Lista de artistas |
Obtener álbumes del artista
Operación
Obtener álbumes del artista
Cuenta de Spotify*
Connect spotify...
ID de artista*
ID de artista de Spotify
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener los álbumes del artista (
spotify_get_artist_albums)Obtén los álbumes de un artista en Spotify. Permite 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 | Álbumes del artista |
total | number | Número total de álbumes disponibles |
next | string | URL de la página siguiente de resultados |
Obtener las canciones más populares del artista
Operación
Obtener canciones más populares del artista
Cuenta de Spotify*
Connect spotify...
ID de artista*
ID de artista de Spotify
Obtener las canciones más populares del artista (
spotify_get_artist_top_tracks)Obtén 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 | Canciones más populares del artista |
Seguir artistas
Operación
Seguir artistas
Cuenta de Spotify*
Connect spotify...
IDs de artistas*
IDs de artistas separados por comas
Seguir artistas (
spotify_follow_artists)Sigue a uno o más artistas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artistIds | string | Sí | IDs de artistas separados por comas a seguir (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si los artistas se siguieron correctamente |
Dejar de seguir artistas
Operación
Dejar de seguir artistas
Cuenta de Spotify*
Connect spotify...
ID de artistas*
ID de artistas separados por comas
Dejar de seguir artistas (
spotify_unfollow_artists)Deja 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 | Indica si los artistas se dejaron de seguir correctamente |
Obtener artistas seguidos
Operación
Obtener artistas seguidos
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener artistas seguidos (
spotify_get_followed_artists)Obtener los artistas seguidos por 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 la paginación (ID del último artista de la solicitud anterior) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
artists | json | Lista de artistas seguidos |
total | número | Número total de artistas seguidos |
next | cadena | Cursor para la página siguiente |
Comprobar seguimiento
Operación
Comprobar seguimiento
Cuenta de Spotify*
Connect spotify...
Tipo
Artista
IDs para comprobar*
IDs de artista o usuario separados por comas
Comprobar seguimiento (
spotify_check_following)Comprueba 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 artista o usuario separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Matriz de booleanos para cada ID |
Obtener programa
Operación
Obtener programa
Cuenta de Spotify*
Connect spotify...
ID del programa*
ID del programa/pódcast de Spotify
Obtener programa (
spotify_get_show)Obtiene los detalles de un programa de podcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showId | string | Sí | El ID del programa de Spotify |
market | string | No | Código de país ISO para el mercado |
Salida
| Parameter | Type | Description |
|---|---|---|
id | string | ID del programa |
name | string | Nombre del programa |
description | string | Descripción del programa |
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 |
Obtener varios programas
Operación
Obtener varios programas
Cuenta de Spotify*
Connect spotify...
ID de programas*
ID de programas separados por comas
Obtener varios programas (
spotify_get_shows)Obtén los detalles de varios programas de pódcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
showIds | string | Sí | IDs de programas 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 programas |
Obtener episodios del programa
Operación
Obtener episodios del programa
Cuenta de Spotify*
Connect spotify...
ID del programa*
ID del programa/podcast de Spotify
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener episodios del programa (
spotify_get_show_episodes)Obtén episodios de un programa de pódcast.
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 de la página siguiente |
Obtener programas guardados
Operación
Obtener programas guardados
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener programas guardados (
spotify_get_saved_shows)Obtén los programas de podcast guardados del 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 de la página siguiente |
Guardar programas
Operación
Guardar programas
Cuenta de Spotify*
Connect spotify...
ID de programas*
ID de programas separados por comas
Guardar programas (
spotify_save_shows)Guardar programas de podcast en la biblioteca del 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 | booleano | Si los programas se guardaron |
Eliminar programas guardados
Operación
Eliminar programas guardados
Cuenta de Spotify*
Connect spotify...
IDs de programas*
IDs de programas separados por comas
Eliminar programas guardados (
spotify_remove_saved_shows)Eliminar programas de podcast de la biblioteca del usuario.
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
showIds | string | Yes | IDs de programas separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si se eliminaron los programas |
Verificar programas guardados
Operación
Comprobar programas guardados
Cuenta de Spotify*
Connect spotify...
ID de programas*
ID de programas separados por comas
Comprobar programas guardados (
spotify_check_saved_shows)Comprueba 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áx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Matriz de valores booleanos para cada programa |
Obtener episodio
Operación
Obtener episodio
Cuenta de Spotify*
Connect spotify...
ID del episodio*
ID del episodio de Spotify
Obtener episodio (
spotify_get_episode)Obtener detalles de un episodio de podcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeId | string | Sí | El ID de 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 imagen de portada |
external_url | string | URL de Spotify |
Obtener varios episodios
Operación
Obtener varios episodios
Cuenta de Spotify*
Connect spotify...
IDs de episodios*
IDs de episodios separados por comas
Obtener varios episodios (
spotify_get_episodes)Obtén los detalles de varios episodios de pódcast.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeIds | string | Sí | IDs de episodio 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 |
Obtener episodios guardados
Operación
Obtener episodios guardados
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener episodios guardados (
spotify_get_saved_episodes)Obtener los episodios de podcast guardados del usuario.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | number | No | Número de episodios que se devolverán (1-50) |
offset | number | No | Índice del primer episodio que se devolverá |
market | string | No | Código de país ISO del mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
episodes | json | Lista de episodios guardados |
total | number | Total de episodios guardados |
next | string | URL para la página siguiente |
Guardar episodios
Operación
Guardar episodios
Cuenta de Spotify*
Connect spotify...
ID de episodios*
ID de episodios separados por comas
Guardar episodios (
spotify_save_episodes)Guarda episodios de pódcast en la biblioteca del 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 | booleano | Indica si los episodios se guardaron |
Eliminar episodios guardados
Operación
Quitar episodios guardados
Cuenta de Spotify*
Connect spotify...
IDs de episodios*
IDs de episodios separados por comas
Eliminar episodios guardados (
spotify_remove_saved_episodes)Elimina episodios de podcast de la biblioteca del usuario.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
episodeIds | string | Sí | IDs de episodios separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si se eliminaron los episodios |
Comprobar episodios guardados
Operación
Comprobar episodios guardados
Cuenta de Spotify*
Connect spotify...
ID de episodios*
ID de episodios separados por comas
Comprobar episodios guardados (
spotify_check_saved_episodes)Comprobar si los episodios están guardados en la biblioteca.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
episodeIds | cadena | Sí | IDs de episodios separados por comas (máximo 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de booleanos para cada episodio |
Obtener audiolibro
Operación
Obtener audiolibro
Cuenta de Spotify*
Connect spotify...
ID de audiolibro*
ID de audiolibro de Spotify
Obtener audiolibro (
spotify_get_audiobook)Obtiene los 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 de 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 |
Obtener varios audiolibros
Operación
Obtener varios audiolibros
Cuenta de Spotify*
Connect spotify...
IDs de audiolibros*
IDs de audiolibros separados por comas
Obtener varios audiolibros (
spotify_get_audiobooks)Obtén los detalles de varios 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 |
Obtener capítulos de audiolibro
Operación
Obtener capítulos del audiolibro
Cuenta de Spotify*
Connect spotify...
ID de audiolibro*
ID de audiolibro de Spotify
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener capítulos de audiolibros (
spotify_get_audiobook_chapters)Obtener los capítulos de un audiolibro.
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookId | string | Yes | 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 del mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
chapters | json | Lista de capítulos |
total | number | Total de capítulos |
next | string | URL de la página siguiente |
Obtener audiolibros guardados
Operación
Obtener audiolibros guardados
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener audiolibros guardados (
spotify_get_saved_audiobooks)Obtiene los audiolibros guardados del 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 de la página siguiente |
Guardar audiolibros
Operación
Guardar audiolibros
Cuenta de Spotify*
Connect spotify...
IDs de audiolibros*
IDs de audiolibros separados por comas
Guardar audiolibros (
spotify_save_audiobooks)Guardar audiolibros en la biblioteca del usuario.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookIds | string | Sí | IDs de audiolibros separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si se guardaron los audiolibros |
Eliminar audiolibros guardados
Operación
Eliminar audiolibros guardados
Cuenta de Spotify*
Connect spotify...
IDs de audiolibros*
IDs de audiolibros separados por comas
Eliminar audiolibros guardados (
spotify_remove_saved_audiobooks)Eliminar audiolibros de la biblioteca del usuario.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
audiobookIds | string | Sí | IDs de audiolibros separados por comas (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Si se eliminaron los audiolibros |
Comprobar audiolibros guardados
Operación
Comprobar audiolibros guardados
Cuenta de Spotify*
Connect spotify...
IDs de audiolibros*
IDs de audiolibros separados por comas
Verificar audiolibros guardados (
spotify_check_saved_audiobooks)Verifica 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áx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Arreglo de booleanos para cada audiolibro |
Obtener lista de reproducción
Operación
Obtener lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de la lista de reproducción*
ID de la lista de reproducción de Spotify
Obtener playlist (
spotify_get_playlist)Obtiene información detallada sobre una playlist de Spotify a partir de su ID.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de Spotify de la playlist |
market | string | No | Código de país ISO 3166-1 alpha-2 para la disponibilidad de las pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de la playlist de Spotify |
name | string | Nombre de la playlist |
description | string | Descripción de la playlist |
public | boolean | Indica si la playlist es pública |
collaborative | boolean | Indica si la playlist es colaborativa |
owner | object | Información del propietario de la playlist |
image_url | string | URL de la imagen de portada de la playlist |
total_tracks | number | Número total de pistas |
snapshot_id | string | ID de instantánea de la playlist para versionado |
external_url | string | URL de Spotify |
Obtener pistas de la playlist
Operación
Obtener pistas de la playlist
Cuenta de Spotify*
Connect spotify...
ID de la playlist*
ID de la playlist de Spotify
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener pistas de la lista de reproducción (
spotify_get_playlist_tracks)Obtener las pistas de una lista de reproducción de Spotify.
Entrada
| Parámetro | Tipo | Requerido | 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 alfa-2 para la disponibilidad de pistas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Lista de pistas de la playlist |
total | number | Número total de pistas en la playlist |
next | string | URL de la página siguiente de resultados |
Obtener portada de la lista de reproducción
Operación
Obtener portada de la playlist
Cuenta de Spotify*
Connect spotify...
ID de playlist*
ID de playlist de Spotify
Obtener portada de la lista de reproducción (
spotify_get_playlist_cover)Obtener la imagen de portada de una lista de reproducción.
Entrada
| Parámetro | Tipo | Requerido | 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 |
Obtener mis listas de reproducción
Operación
Obtener mis listas de reproducción
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener mis listas de reproducción (
spotify_get_user_playlists)Obtén las listas de reproducción del usuario actual en Spotify.
Entrada
| Parámetro | Tipo | Requerido | 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 | Listas de reproducción del usuario |
total | number | Número total de listas de reproducción |
next | string | URL de la página siguiente |
Crear lista de reproducción
Operación
Crear lista de reproducción
Cuenta de Spotify*
Connect spotify...
Nombre de la lista de reproducción*
Mi lista de reproducción
Descripción de la lista de reproducción
Descripción opcional de la lista de reproducción
Pública
Enabled
Crear playlist (
spotify_create_playlist)Crea una nueva playlist para el usuario actual en Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre para la nueva playlist |
description | string | No | Descripción de la playlist |
public | boolean | No | Si la playlist debe ser pública |
collaborative | boolean | No | Si la playlist 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 | Indica si la lista es pública |
collaborative | boolean | Indica si es colaborativa |
snapshot_id | string | ID de instantánea de la lista |
external_url | string | URL de Spotify |
Actualizar playlist
Operación
Actualizar lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de la lista de reproducción*
ID de la lista de reproducción de Spotify
Nombre nuevo
Nombre nuevo de la lista de reproducción (opcional)
Descripción de la lista de reproducción
Descripción opcional de la lista de reproducción
Pública
Enabled
Actualizar lista de reproducción (
spotify_update_playlist)Actualiza el nombre, la descripción o la visibilidad de una lista de reproducción.
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
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 | Indica si la lista de reproducción debe ser pública |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Si la actualización se realizó correctamente |
Añadir portada de la lista de reproducción
Operación
Añadir portada de lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de lista de reproducción*
ID de lista de reproducción de Spotify
Imagen (Base64)*
Imagen JPEG codificada en Base64 (máx. 256KB)
Agregar portada de la lista de reproducción (
spotify_add_playlist_cover)Sube una imagen de portada personalizada para una lista de reproducción. La imagen debe ser JPEG y pesar menos de 256 KB.
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. 256 KB) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si la carga se realizó correctamente |
Agregar pistas a la lista de reproducción
Operación
Añadir canciones a la lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de lista de reproducción*
ID de lista de reproducción de Spotify
URIs de canciones*
spotify:track:xxx,spotify:track:yyy
Añadir pistas a la lista de reproducción (
spotify_add_tracks_to_playlist)Añade 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 separados por comas (p. ej., "spotify:track:xxx,spotify:track:yyy") |
position | number | No | Posición para insertar pistas (basada en 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 |
Eliminar pistas de la lista de reproducción
Operación
Eliminar pistas de la lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de la lista de reproducción*
ID de la lista de reproducción de Spotify
URI de pistas*
spotify:track:xxx,spotify:track:yyy
Eliminar pistas de la lista de reproducción (
spotify_remove_tracks_from_playlist)Elimina una o más pistas de una lista de reproducción de Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
playlistId | string | Yes | El ID de Spotify de la lista de reproducción |
uris | string | Yes | URIs de Spotify separadas por comas para eliminar (ej., "spotify:track:xxx,spotify:track:yyy") |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
snapshot_id | string | Nuevo ID de instantánea de lista de reproducción después de la modificación |
Reordenar elementos de la lista de reproducción
Operación
Reordenar elementos de la lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de lista de reproducción*
ID de lista de reproducción de Spotify
Inicio del rango*
Índice inicial de los elementos a mover
Insertar antes*
Índice antes del cual insertar
Longitud del rango
Número de elementos a mover (predeterminado: 1)
Reordenar elementos de la lista de reproducció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 antes del cual 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 snapshot de lista de reproducción |
Reemplazar elementos de la lista de reproducción
Operación
Reemplazar elementos de la lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de lista de reproducción*
ID de lista de reproducción de Spotify
URIs de canciones*
spotify:track:xxx,spotify:track:yyy
Reemplazar elementos de la lista de reproducción (
spotify_replace_playlist_items)Reemplazar todos los elementos de una lista de reproducción con nuevas pistas.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de la lista de reproducción de Spotify |
uris | string | Sí | URI de Spotify separados por comas (max 100) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
snapshot_id | string | ID de instantánea de lista de reproducción nueva |
Seguir lista de reproducción
Operación
Seguir lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de lista de reproducción*
ID de lista de reproducción de Spotify
Pública
Enabled
Seguir 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 públicas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Si el seguimiento se realizó correctamente |
Dejar de seguir lista de reproducción
Operación
Dejar de seguir lista de reproducción
Cuenta de Spotify*
Connect spotify...
ID de la lista de reproducción*
ID de la lista de reproducción de Spotify
Dejar de seguir lista de reproducción (
spotify_unfollow_playlist)Dejar de seguir (quitar de guardados) una lista de reproducción.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
playlistId | string | Sí | El ID de lista de reproducción de Spotify |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si se dejó de seguir correctamente |
Comprobar seguidores de la lista de reproducción
Operación
Comprobar seguidores de la playlist
Cuenta de Spotify*
Connect spotify...
ID de playlist*
ID de playlist de Spotify
IDs de usuario*
IDs de usuario separados por comas para comprobar (máx. 5)
Comprobar seguidores de la lista de reproducción (
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 a comprobar (máx. 5) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Arreglo de booleanos para cada usuario |
Obtener mi perfil
Operación
Obtener mi perfil
Cuenta de Spotify*
Connect spotify...
Obtener mi perfil (
spotify_get_current_user)Obtén la información del perfil del usuario actual de Spotify.
Entrada
Esta operación no tiene parámetros directos.
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID de usuario de Spotify |
display_name | string | Nombre para mostrar |
email | string | Dirección de correo electrónico |
country | string | Código de país |
product | string | Nivel de suscripción (gratis, premium) |
followers | number | Número de seguidores |
image_url | string | URL de la imagen de perfil |
external_url | string | URL del perfil de Spotify |
Obtener perfil de usuario
Operación
Obtener perfil de usuario
Cuenta de Spotify*
Connect spotify...
ID de usuario*
ID de usuario de Spotify
Obtener perfil de usuario (
spotify_get_user_profile)Obtén el perfil público de 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 para mostrar |
followers | number | Número de seguidores |
image_url | string | URL de la imagen de perfil |
external_url | string | URL de Spotify |
Obtener mis canciones más escuchadas
Operación
Obtener mis canciones más populares
Cuenta de Spotify*
Connect spotify...
Periodo de tiempo
Últimos 6 meses
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener mis canciones más escuchadas (
spotify_get_top_tracks)Obtén los temas más escuchados del usuario actual según su historial de escucha.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
time_range | string | No | Intervalo de tiempo: short_term (~4 semanas), medium_term (~6 meses), long_term (años) |
limit | number | No | Número de canciones que se devuelven (1-50) |
offset | number | No | Índice de la primera canción que se devuelve |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Temas más escuchados del usuario |
total | number | Número total de temas más escuchados |
next | string | URL de la página siguiente |
Obtener mis artistas más escuchados
Operación
Obtener mis artistas más escuchados
Cuenta de Spotify*
Connect spotify...
Intervalo de tiempo
Últimos 6 meses
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener mis artistas más escuchados (
spotify_get_top_artists)Obtén los artistas más escuchados del usuario actual según su historial de reproducción.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
time_range | string | No | Intervalo 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 | Artistas más escuchados del usuario |
total | number | Número total de artistas más escuchados |
next | string | URL de la página siguiente |
Obtener pistas guardadas
Operación
Obtener canciones guardadas
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener pistas guardadas (
spotify_get_saved_tracks)Obtener las canciones guardadas o favoritas del usuario actual desde su biblioteca.
Entrada
| Parámetro | Tipo | Requerido | 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 alfa-2 |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tracks | array | Canciones guardadas del usuario |
total | number | Número total de canciones guardadas |
next | string | URL de la página siguiente |
Guardar pistas
Operación
Guardar canciones
Cuenta de Spotify*
Connect spotify...
ID de canciones*
ID de canciones separados por comas
Guardar canciones (
spotify_save_tracks)Guarda canciones en la biblioteca del usuario actual (marcar como me gusta).
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | IDs de canciones de Spotify separados por comas que se van a guardar (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si las canciones se guardaron correctamente |
Eliminar canciones guardadas
Operación
Eliminar canciones guardadas
Cuenta de Spotify*
Connect spotify...
IDs de canciones*
IDs de canciones separados por comas
Eliminar pistas guardadas (
spotify_remove_saved_tracks)Elimina pistas de la biblioteca del usuario.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
trackIds | string | Sí | IDs de pistas separados por comas que se van a eliminar (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si las pistas se eliminaron correctamente |
Comprobar pistas guardadas
Operación
Comprobar pistas guardadas
Cuenta de Spotify*
Connect spotify...
ID de pistas*
ID de pistas separados por comas
Verificar pistas guardadas (
spotify_check_saved_tracks)Comprueba si una o más pistas están guardadas en la biblioteca del usuario.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
trackIds | string | Sí | IDs de pistas separados por comas para verificar (máx. 50) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | json | Array de ID de pistas con estado guardado |
all_saved | boolean | Indica si todas las pistas están guardadas |
none_saved | boolean | Indica si no hay pistas guardadas |
Obtener reproducidos recientemente
Operación
Obtener reproducciones recientes
Cuenta de Spotify*
Connect spotify...
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener reproducidos recientemente (
spotify_get_recently_played)Obtiene las pistas reproducidas recientemente del 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 |
next | string | URL de la página siguiente |
Obtener nuevos lanzamientos
Operación
Obtener novedades
Cuenta de Spotify*
Connect spotify...
País
Código de país ISO (p. ej., US, GB)
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener novedades (
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 novedades |
total | number | Número total de novedades |
next | string | URL de la página siguiente |
Obtener categorías
Operación
Obtener categorías
Cuenta de Spotify*
Connect spotify...
País
Código de país ISO (p. ej., US, GB)
Límite
Número de resultados (1-50, predeterminado: 20)
Obtener categorías (
spotify_get_categories)Obtener una lista de categorías de exploración usadas para etiquetar elementos en Spotify.
Entrada
| Parámetro | Tipo | Obligatorio | 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 configuración regional (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 exploración |
total | number | Número total de categorías |
Obtener mercados disponibles
Operación
Obtener mercados disponibles
Cuenta de Spotify*
Connect spotify...
Obtener mercados disponibles (
spotify_get_markets)Obtener la lista de mercados en los que Spotify está disponible.
Entrada
Esta operación no tiene parámetros directos.
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
markets | json | Lista de códigos de país ISO |
Obtener estado de reproducción
Operación
Obtener estado de reproducción
Cuenta de Spotify*
Connect spotify...
Obtener estado de reproducción (
spotify_get_playback_state)Obtener el estado de reproducción actual, incluidos dispositivo, pista y progreso.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
market | string | No | Código de país ISO 3166-1 alfa-2 |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
is_playing | boolean | Indica 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 | Indica si la reproducción aleatoria está habilitada |
repeat_state | string | Modo de repetición (desactivado, pista, contexto) |
track | object | Pista en reproducción actual |
Obtener reproducción actual
Operación
Obtener reproducción actual
Cuenta de Spotify*
Connect spotify...
Obtener reproducción actual (
spotify_get_currently_playing)Obtener la pista que el usuario está reproduciendo actualmente.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
market | string | No | Código de país ISO para el mercado |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
is_playing | boolean | Indica si la reproducción está activa |
progress_ms | number | Posición actual en la pista (ms) |
track | json | Pista en reproducción actual |
Obtener dispositivos
Operación
Obtener dispositivos
Cuenta de Spotify*
Connect spotify...
Obtener dispositivos (
spotify_get_devices)Obtener los dispositivos de reproducción de Spotify disponibles del usuario.
Entrada
Esta operación no tiene parámetros directos.
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
devices | array | Dispositivos de reproducción disponibles |
Obtener cola
Operación
Obtener cola
Cuenta de Spotify*
Connect spotify...
Obtener cola (
spotify_get_queue)Obtiene la cola de reproducción del usuario.
Entrada
Esta operación no tiene parámetros directos.
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
currently_playing | json | Pista en reproducción actual |
queue | json | Próximas pistas en la cola |
Reproducir
Operación
Reproducir
Cuenta de Spotify*
Connect spotify...
ID de dispositivo
Opcional: usa el dispositivo activo si no se especifica
URI de contexto
spotify:album:xxx o spotify:playlist:yyy
URI de pistas
spotify:track:xxx (separadas por comas para varias)
Reproducir (
spotify_play)Inicia o reanuda la reproducción en Spotify. Puede reproducir pistas, álbumes o listas de reproducción específicas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
device_id | string | No | ID del dispositivo en el que 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 | URI de pistas separadas por comas a reproducir (p. ej., "spotify:track:xxx,spotify:track:yyy") |
offset | number | No | Posición en el contexto para comenzar la reproducción (índice basado en 0) |
position_ms | number | No | Posición en la pista desde la que comenzar (en milisegundos) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la reproducción se inició correctamente |
Pausa
Operación
Pausar
Cuenta de Spotify*
Connect spotify...
ID del dispositivo
Opcional: usa el dispositivo activo si no se especifica
Pausa (
spotify_pause)Pausar la reproducción en Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
device_id | string | No | ID de dispositivo para pausar. Si no se proporciona, pausa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la reproducción se pausó |
Saltar a la siguiente
Operación
Saltar a la siguiente
Cuenta de Spotify*
Connect spotify...
ID de dispositivo
Opcional: usa el dispositivo activo si no se especifica
Saltar a la siguiente (
spotify_skip_next)Saltar a la siguiente pista en Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
device_id | cadena | No | ID del dispositivo. Si no se proporciona, usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Si la omisión fue exitosa |
Saltar a la anterior
Operación
Saltar a la anterior
Cuenta de Spotify*
Connect spotify...
ID del dispositivo
Opcional - usa el dispositivo activo si no se especifica
Saltar a la anterior (
spotify_skip_previous)Salta a la pista anterior en Spotify.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
device_id | string | No | ID de dispositivo. Si no se proporciona, usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la omisión fue exitosa |
Ir a
Operación
Ir a
Cuenta de Spotify*
Connect spotify...
ID de dispositivo
Opcional: usa el dispositivo activo si no se especifica
Posición (ms)*
Posición en milisegundos
Buscar (
spotify_seek)Buscar una posición en la pista actual.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
position_ms | número | Sí | Posición en milisegundos a la que buscar |
device_id | cadena | No | ID del dispositivo al que apuntar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Indica si la búsqueda fue exitosa |
Añadir a la cola
Operación
Añadir a la cola
Cuenta de Spotify*
Connect spotify...
ID del dispositivo
Opcional: usa el dispositivo activo si no se especifica
URI de la pista*
spotify:track:xxx
Añadir a la cola (
spotify_add_to_queue)Añade una pista a la cola de reproducción del usuario.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
uri | string | Sí | URI de Spotify de la pista que se va a añadir (p. ej., "spotify:track:xxx") |
device_id | string | No | ID del dispositivo. Si no se proporciona, se usa el dispositivo activo. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la pista se añadió a la cola |
Establecer volumen
Operación
Establecer volumen
Cuenta de Spotify*
Connect spotify...
ID del dispositivo
Opcional - usa el dispositivo activo si no se especifica
Volumen
0
Ajustar volumen (
spotify_set_volume)Ajusta el volumen de reproducción en Spotify.
Entrada
| Parámetro | Tipo | Requerido | 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 se estableció el volumen |
Establecer repetición
Operación
Establecer repetición
Cuenta de Spotify*
Connect spotify...
ID del dispositivo
Opcional: usa el dispositivo activo si no se especifica
Modo de repetición
Desactivado
Establecer repetición (
spotify_set_repeat)Establece 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 de destino |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el modo de repetición se estableció correctamente |
Establecer aleatorio
Operación
Establecer aleatorio
Cuenta de Spotify*
Connect spotify...
ID del dispositivo
Opcional: usa el dispositivo activo si no se especifica
Aleatorio
Disabled
Configurar aleatorio (
spotify_set_shuffle)Activa o desactiva la reproducción aleatoria.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
state | boolean | Sí | true para activar el modo aleatorio, false para desactivarlo |
device_id | string | No | ID del dispositivo de destino |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si el modo aleatorio se configuró correctamente |
Transferir reproducción
Operación
Transferir reproducción
Cuenta de Spotify*
Connect spotify...
ID del dispositivo de destino*
ID del dispositivo al que transferir
Transferir reproducción (
spotify_transfer_playback)Transferir la reproducción a otro dispositivo.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
device_id | string | Sí | ID del dispositivo al que transferir la reproducción |
play | boolean | No | Si se debe comenzar a reproducir en el nuevo dispositivo |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Si la transferencia fue exitosa |
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.
Notas
- Categoría:
tools - Tipo:
spotify