Spotify

Recherchez de la musique, gérez des playlists, contrôlez la lecture et accédez à votre bibliothèque

Instructions d'utilisation

Intégrez Spotify dans votre flux de travail. Recherchez des morceaux, albums, artistes et playlists. Gérez des playlists, accédez à votre bibliothèque, contrôlez la lecture, parcourez les podcasts et les livres audio.

Outils

`spotify_search`

Recherchez des morceaux, albums, artistes ou playlists sur Spotify. Renvoie les résultats correspondants basés sur la requête.

Entrée

Paramètre	Type	Obligatoire	Description
`query`	string	Oui	Requête de recherche (ex. : "Bohemian Rhapsody", "artist:Queen", "genre:rock")
`type`	string	Non	Type de résultats : track, album, artist, playlist, ou séparés par virgules (ex. : "track,artist")
`limit`	number	Non	Nombre maximum de résultats à renvoyer (1-50)
`offset`	number	Non	Index du premier résultat à renvoyer pour la pagination
`market`	string	Non	Code pays ISO 3166-1 alpha-2 pour filtrer les résultats (ex. : "US", "GB")

Sortie

Paramètre	Type	Description
`tracks`	array	Liste des morceaux correspondants

`spotify_get_track`

Obtenez des informations détaillées sur un morceau spécifique sur Spotify par son ID.

Entrée

Paramètre	Type	Obligatoire	Description
`trackId`	string	Oui	L'ID Spotify du morceau
`market`	string	Non	Code pays ISO 3166-1 alpha-2 pour la disponibilité du morceau

Sortie

Paramètre	Type	Description
`id`	string	ID de piste Spotify
`name`	string	Nom de la piste
`artists`	array	Liste des artistes
`album`	object	Informations sur l'album
`duration_ms`	number	Durée de la piste en millisecondes
`explicit`	boolean	Si la piste contient du contenu explicite
`popularity`	number	Score de popularité (0-100)
`preview_url`	string	URL vers un aperçu de 30 secondes
`external_url`	string	URL Spotify
`uri`	string	URI Spotify pour la piste

`spotify_get_tracks`

Obtenir des informations détaillées sur plusieurs pistes Spotify par leurs identifiants (jusqu'à 50).

Entrée

Paramètre	Type	Obligatoire	Description
`trackIds`	string	Oui	Liste d'identifiants de pistes Spotify séparés par des virgules (max 50)
`market`	string	Non	Code pays ISO 3166-1 alpha-2 pour la disponibilité des pistes

Sortie

Paramètre	Type	Description
`tracks`	array	Liste des pistes

`spotify_get_album`

Obtenir des informations détaillées sur un album Spotify par son identifiant, y compris la liste des pistes.

Entrée

Paramètre	Type	Obligatoire	Description
`albumId`	string	Oui	L'identifiant Spotify de l'album
`market`	string	Non	Code pays ISO 3166-1 alpha-2 pour la disponibilité des pistes

Sortie

Paramètre	Type	Description
`id`	string	ID d'album Spotify
`name`	string	Nom de l'album
`artists`	array	Liste des artistes
`album_type`	string	Type d'album (album, single, compilation)
`total_tracks`	number	Nombre total de pistes
`release_date`	string	Date de sortie
`label`	string	Maison de disques
`popularity`	number	Score de popularité (0-100)
`genres`	array	Liste des genres
`image_url`	string	URL de l'image de couverture de l'album
`tracks`	array	Liste des pistes de l'album
`external_url`	string	URL Spotify

`spotify_get_albums`

Obtenir les détails de plusieurs albums par leurs identifiants.

Entrée

Paramètre	Type	Obligatoire	Description
`albumIds`	string	Oui	Identifiants d'albums séparés par des virgules (max 20)
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`albums`	json	Liste des albums

`spotify_get_album_tracks`

Obtenir les pistes d'un album.

Entrée

Paramètre	Type	Obligatoire	Description
`albumId`	string	Oui	L'identifiant de l'album Spotify
`limit`	number	Non	Nombre de pistes à retourner (1-50)
`offset`	number	Non	Index de la première piste à retourner

Sortie

Paramètre	Type	Description
`tracks`	json	Liste des pistes
`total`	number	Nombre total de pistes
`next`	string	URL pour la page suivante

`spotify_get_saved_albums`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	number	Non	Nombre d'albums à retourner (1-50)
`offset`	number	Non	Index du premier album à retourner
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`albums`	json	Liste des albums sauvegardés
`total`	number	Total des albums sauvegardés
`next`	string	URL pour la page suivante

`spotify_save_albums`

Sauvegarder des albums pour l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`albumIds`	string	Oui	IDs d'albums séparés par des virgules (max 20)

Sortie

Paramètre	Type	Description
`success`	boolean	Si les albums ont été sauvegardés

`spotify_remove_saved_albums`

Supprimer des albums de l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`albumIds`	string	Oui	IDs d'albums séparés par des virgules (max 20)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les albums ont été supprimés

`spotify_check_saved_albums`

Vérifier si les albums sont enregistrés dans la bibliothèque.

Entrée

Paramètre	Type	Obligatoire	Description
`albumIds`	string	Oui	IDs d'albums séparés par des virgules (max 20)

Sortie

Paramètre	Type	Description
`results`	json	Tableau de booléens pour chaque album

`spotify_get_artist`

Obtenir des informations détaillées sur un artiste Spotify à partir de son ID.

Entrée

Paramètre	Type	Obligatoire	Description
`artistId`	string	Oui	L'ID Spotify de l'artiste

Sortie

Paramètre	Type	Description
`id`	string	ID de l'artiste Spotify
`name`	string	Nom de l'artiste
`genres`	array	Liste des genres associés à l'artiste
`popularity`	number	Score de popularité (0-100)
`followers`	number	Nombre d'abonnés
`image_url`	string	URL de l'image de l'artiste
`external_url`	string	URL Spotify

`spotify_get_artists`

Obtenir les détails de plusieurs artistes à partir de leurs IDs.

Entrée

Paramètre	Type	Obligatoire	Description
`artistIds`	string	Oui	IDs d'artistes séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`artists`	json	Liste des artistes

`spotify_get_artist_albums`

Obtenir les albums d'un artiste sur Spotify. Peut filtrer par type d'album.

Entrée

Paramètre	Type	Obligatoire	Description
`artistId`	string	Oui	L'identifiant Spotify de l'artiste
`include_groups`	string	Non	Filtrer par type d'album : album, single, appears_on, compilation (séparés par des virgules)
`limit`	number	Non	Nombre maximum d'albums à retourner (1-50)
`offset`	number	Non	Index du premier album à retourner
`market`	string	Non	Code pays ISO 3166-1 alpha-2

Sortie

Paramètre	Type	Description
`albums`	array	Artiste

`spotify_get_artist_top_tracks`

Obtenir les 10 titres les plus populaires d'un artiste sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`artistId`	string	Oui	L'identifiant Spotify de l'artiste
`market`	string	Non	Code pays ISO 3166-1 alpha-2 (requis pour ce point de terminaison)

Sortie

Paramètre	Type	Description
`tracks`	array	Artiste

`spotify_follow_artists`

Suivre un ou plusieurs artistes.

Entrée

Paramètre	Type	Obligatoire	Description
`artistIds`	string	Oui	IDs d'artistes séparés par des virgules à suivre (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les artistes ont été suivis avec succès

`spotify_unfollow_artists`

Ne plus suivre un ou plusieurs artistes.

Entrée

Paramètre	Type	Obligatoire	Description
`artistIds`	string	Oui	IDs d'artistes séparés par des virgules à ne plus suivre (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les artistes ont été retirés des suivis avec succès

`spotify_get_followed_artists`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	number	Non	Nombre d'artistes à retourner (1-50)
`after`	string	Non	Curseur pour la pagination (dernier ID d'artiste de la requête précédente)

Sortie

Paramètre	Type	Description
`artists`	json	Liste des artistes suivis
`total`	number	Nombre total d'artistes suivis
`next`	string	Curseur pour la page suivante

`spotify_check_following`

Vérifier si l'utilisateur suit des artistes ou d'autres utilisateurs.

Entrée

Paramètre	Type	Obligatoire	Description
`type`	string	Oui	Type à vérifier : "artist" ou "user"
`ids`	string	Oui	IDs d'artistes ou d'utilisateurs séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`results`	json	Tableau de booléens pour chaque ID

`spotify_get_show`

Obtenir les détails d'une émission de podcast.

Entrée

Paramètre	Type	Obligatoire	Description
`showId`	string	Oui	L'ID de l'émission Spotify
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`id`	string	ID de l'émission
`name`	string	Nom de l'émission
`description`	string	Description de l'émission
`publisher`	string	Nom de l'éditeur
`total_episodes`	number	Nombre total d'épisodes
`explicit`	boolean	Contient du contenu explicite
`languages`	json	Langues
`image_url`	string	URL de l'image de couverture
`external_url`	string	URL Spotify

`spotify_get_shows`

Obtenir les détails de plusieurs émissions de podcast.

Entrée

Paramètre	Type	Obligatoire	Description
`showIds`	string	Oui	IDs d'émissions séparés par des virgules (max 50)
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`shows`	json	Liste des émissions

`spotify_get_show_episodes`

Obtenir les épisodes d'une émission de podcast.

Entrée

Paramètre	Type	Obligatoire	Description
`showId`	string	Oui	L'identifiant Spotify de l'émission
`limit`	number	Non	Nombre d'épisodes à retourner (1-50)
`offset`	number	Non	Index du premier épisode à retourner
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`episodes`	json	Liste des épisodes
`total`	number	Nombre total d'épisodes
`next`	string	URL pour la page suivante

`spotify_get_saved_shows`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	number	Non	Nombre d'émissions à retourner (1-50)
`offset`	number	Non	Index de la première émission à retourner

Sortie

Paramètre	Type	Description
`shows`	json	Liste des émissions enregistrées
`total`	number	Nombre total d'émissions enregistrées
`next`	string	URL pour la page suivante

`spotify_save_shows`

Enregistrer des émissions de podcast pour l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`showIds`	string	Oui	Identifiants d'émissions séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les émissions ont été enregistrées

`spotify_remove_saved_shows`

Supprimer des émissions de podcast de l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`showIds`	string	Oui	IDs d'émissions séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les émissions ont été supprimées

`spotify_check_saved_shows`

Vérifier si les émissions sont enregistrées dans la bibliothèque.

Entrée

Paramètre	Type	Obligatoire	Description
`showIds`	string	Oui	IDs d'émissions séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`results`	json	Tableau de booléens pour chaque émission

`spotify_get_episode`

Obtenir les détails d'un épisode de podcast.

Entrée

Paramètre	Type	Obligatoire	Description
`episodeId`	string	Oui	L'ID de l'épisode Spotify
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`id`	string	ID de l'épisode
`name`	string	Nom de l'épisode
`description`	string	Description de l'épisode
`duration_ms`	number	Durée en ms
`release_date`	string	Date de sortie
`explicit`	boolean	Contient du contenu explicite
`show`	json	Informations sur l'émission parente
`image_url`	string	URL de l'image de couverture
`external_url`	string	URL Spotify

`spotify_get_episodes`

Obtenir les détails de plusieurs épisodes de podcast.

Entrée

Paramètre	Type	Obligatoire	Description
`episodeIds`	chaîne	Oui	IDs d'épisodes séparés par des virgules (max 50)
`market`	chaîne	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`episodes`	json	Liste des épisodes

`spotify_get_saved_episodes`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	nombre	Non	Nombre d'épisodes à retourner (1-50)
`offset`	nombre	Non	Index du premier épisode à retourner
`market`	chaîne	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`episodes`	json	Liste des épisodes enregistrés
`total`	nombre	Total des épisodes enregistrés
`next`	chaîne	URL pour la page suivante

`spotify_save_episodes`

Enregistrer des épisodes de podcast pour l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`episodeIds`	chaîne	Oui	IDs d'épisodes séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`success`	booléen	Si les épisodes ont été enregistrés

`spotify_remove_saved_episodes`

Supprimer des épisodes de podcast de l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`episodeIds`	string	Oui	IDs d'épisodes séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les épisodes ont été supprimés

`spotify_check_saved_episodes`

Vérifier si les épisodes sont enregistrés dans la bibliothèque.

Entrée

Paramètre	Type	Obligatoire	Description
`episodeIds`	string	Oui	IDs d'épisodes séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`results`	json	Tableau de booléens pour chaque épisode

`spotify_get_audiobook`

Obtenir les détails d'un livre audio.

Entrée

Paramètre	Type	Obligatoire	Description
`audiobookId`	string	Oui	L'ID du livre audio Spotify
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`id`	string	ID du livre audio
`name`	string	Nom du livre audio
`authors`	json	Auteurs
`narrators`	json	Narrateurs
`publisher`	string	Éditeur
`description`	string	Description
`total_chapters`	number	Nombre total de chapitres
`languages`	json	Langues
`image_url`	string	URL de l'image de couverture
`external_url`	string	URL Spotify

`spotify_get_audiobooks`

Obtenir les détails de plusieurs livres audio.

Entrée

Paramètre	Type	Obligatoire	Description
`audiobookIds`	chaîne	Oui	IDs de livres audio séparés par des virgules (max 50)
`market`	chaîne	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`audiobooks`	json	Liste des livres audio

`spotify_get_audiobook_chapters`

Obtenir les chapitres d'un livre audio.

Entrée

Paramètre	Type	Obligatoire	Description
`audiobookId`	chaîne	Oui	L'ID Spotify du livre audio
`limit`	nombre	Non	Nombre de chapitres à retourner (1-50)
`offset`	nombre	Non	Index du premier chapitre à retourner
`market`	chaîne	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`chapters`	json	Liste des chapitres
`total`	nombre	Total des chapitres
`next`	chaîne	URL pour la page suivante

`spotify_get_saved_audiobooks`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	nombre	Non	Nombre de livres audio à retourner (1-50)
`offset`	nombre	Non	Index du premier livre audio à retourner

Sortie

Paramètre	Type	Description
`audiobooks`	json	Liste des livres audio enregistrés
`total`	number	Nombre total de livres audio enregistrés
`next`	string	URL pour la page suivante

`spotify_save_audiobooks`

Enregistrer des livres audio pour l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`audiobookIds`	string	Oui	IDs de livres audio séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les livres audio ont été enregistrés

`spotify_remove_saved_audiobooks`

Supprimer des livres audio de l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`audiobookIds`	string	Oui	IDs de livres audio séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si les livres audio ont été supprimés

`spotify_check_saved_audiobooks`

Vérifier si les livres audio sont enregistrés dans la bibliothèque.

Entrée

Paramètre	Type	Obligatoire	Description
`audiobookIds`	string	Oui	IDs de livres audio séparés par des virgules (max 50)

Sortie

Paramètre	Type	Description
`results`	json	Tableau de booléens pour chaque livre audio

`spotify_get_playlist`

Obtenir des informations détaillées sur une playlist Spotify par son ID.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	chaîne	Oui	L'identifiant Spotify de la playlist
`market`	chaîne	Non	Code pays ISO 3166-1 alpha-2 pour la disponibilité des pistes

Sortie

Paramètre	Type	Description
`id`	chaîne	Identifiant de la playlist Spotify
`name`	chaîne	Nom de la playlist
`description`	chaîne	Description de la playlist
`public`	booléen	Si la playlist est publique
`collaborative`	booléen	Si la playlist est collaborative
`owner`	objet	Informations sur le propriétaire de la playlist
`image_url`	chaîne	URL de l'image de couverture de la playlist
`total_tracks`	nombre	Nombre total de pistes
`snapshot_id`	chaîne	ID d'instantané de la playlist pour le versionnement
`external_url`	chaîne	URL Spotify

`spotify_get_playlist_tracks`

Obtenir les pistes d'une playlist Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	chaîne	Oui	L'identifiant Spotify de la playlist
`limit`	nombre	Non	Nombre maximum de pistes à retourner (1-100)
`offset`	nombre	Non	Index de la première piste à retourner
`market`	chaîne	Non	Code pays ISO 3166-1 alpha-2 pour la disponibilité des pistes

Sortie

Paramètre	Type	Description
`tracks`	array	Liste des pistes dans la playlist

`spotify_get_playlist_cover`

Obtenir une playlist

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'identifiant Spotify de la playlist

Sortie

Paramètre	Type	Description
`images`	json	Liste des images de couverture

`spotify_get_user_playlists`

Obtenir l'utilisateur actuel

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	number	Non	Nombre maximum de playlists à retourner (1-50)
`offset`	number	Non	Index de la première playlist à retourner

Sortie

Paramètre	Type	Description
`playlists`	array	Utilisateur

`spotify_create_playlist`

Créer une nouvelle playlist pour l'utilisateur actuel sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`name`	string	Oui	Nom de la nouvelle playlist
`description`	string	Non	Description de la playlist
`public`	boolean	Non	Si la playlist doit être publique
`collaborative`	boolean	Non	Si la playlist doit être collaborative (nécessite que public soit défini sur false)

Sortie

Paramètre	Type	Description
`id`	string	ID de la playlist Spotify
`name`	string	Nom de la playlist
`description`	string	Description de la playlist
`public`	boolean	Si la playlist est publique
`collaborative`	boolean	Si collaborative
`snapshot_id`	string	ID d'instantané de la playlist
`external_url`	string	URL Spotify

`spotify_update_playlist`

Mettre à jour une playlist

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'ID de la playlist Spotify
`name`	string	Non	Nouveau nom pour la playlist
`description`	string	Non	Nouvelle description pour la playlist
`public`	boolean	Non	Si la playlist doit être publique

Sortie

Paramètre	Type	Description
`success`	boolean	Si la mise à jour a réussi

`spotify_add_playlist_cover`

Télécharger une image de couverture personnalisée pour une playlist. L'image doit être au format JPEG et inférieure à 256 Ko.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'ID de la playlist Spotify
`imageBase64`	string	Oui	Image JPEG encodée en Base64 (max 256 Ko)

Sortie

Paramètre	Type	Description
`success`	boolean	Si le téléchargement a réussi

`spotify_add_tracks_to_playlist`

Ajouter une ou plusieurs pistes à une playlist Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'identifiant Spotify de la playlist
`uris`	string	Oui	URIs Spotify séparées par des virgules (ex., "spotify:track:xxx,spotify:track:yyy")
`position`	number	Non	Position pour insérer les pistes (à partir de 0). Si omis, les pistes sont ajoutées à la fin.

Sortie

Paramètre	Type	Description
`snapshot_id`	string	Nouvel identifiant d'instantané de playlist après modification

`spotify_remove_tracks_from_playlist`

Supprimer une ou plusieurs pistes d'une playlist Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'identifiant Spotify de la playlist
`uris`	string	Oui	URIs Spotify séparées par des virgules à supprimer (ex., "spotify:track:xxx,spotify:track:yyy")

Sortie

Paramètre	Type	Description
`snapshot_id`	string	Nouvel identifiant d'instantané de playlist après modification

`spotify_reorder_playlist_items`

Déplacer des pistes vers une position différente dans une playlist.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'identifiant de la playlist Spotify
`range_start`	number	Oui	Index de départ des éléments à réorganiser
`insert_before`	number	Oui	Index avant lequel insérer les éléments
`range_length`	number	Non	Nombre d'éléments à réorganiser
`snapshot_id`	string	Non	Identifiant d'instantané de playlist pour le contrôle de concurrence

Sortie

Paramètre	Type	Description
`snapshot_id`	string	Nouvel ID d'instantané de playlist

`spotify_replace_playlist_items`

Remplacer tous les éléments d'une playlist par de nouvelles pistes.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'ID de playlist Spotify
`uris`	string	Oui	URIs Spotify séparées par des virgules (max 100)

Sortie

Paramètre	Type	Description
`snapshot_id`	string	Nouvel ID d'instantané de playlist

`spotify_follow_playlist`

Suivre (sauvegarder) une playlist.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'ID de playlist Spotify
`public`	boolean	Non	Si la playlist sera dans les playlists publiques

Sortie

Paramètre	Type	Description
`success`	boolean	Si le suivi a réussi

`spotify_unfollow_playlist`

Ne plus suivre (désauvegarder) une playlist.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'ID de playlist Spotify

Sortie

Paramètre	Type	Description
`success`	boolean	Si le désabonnement a réussi

`spotify_check_playlist_followers`

Vérifier si les utilisateurs suivent une playlist.

Entrée

Paramètre	Type	Obligatoire	Description
`playlistId`	string	Oui	L'identifiant de la playlist Spotify
`userIds`	string	Oui	Identifiants d'utilisateurs séparés par des virgules à vérifier (max 5)

Sortie

Paramètre	Type	Description
`results`	json	Tableau de booléens pour chaque utilisateur

`spotify_get_current_user`

Obtenir l'utilisateur actuel

Entrée

Paramètre	Type	Obligatoire	Description

Sortie

Paramètre	Type	Description
`id`	string	Identifiant d'utilisateur Spotify
`display_name`	string	Nom d'affichage
`email`	string	Adresse e-mail
`country`	string	Code pays
`product`	string	Niveau d'abonnement (gratuit, premium)
`followers`	number	Nombre d'abonnés
`image_url`	string	URL de l'image de profil
`external_url`	string	URL du profil Spotify

`spotify_get_user_profile`

Obtenir un utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`userId`	string	Oui	L'identifiant d'utilisateur Spotify

Sortie

Paramètre	Type	Description
`id`	string	Identifiant d'utilisateur
`display_name`	string	Nom d'affichage
`followers`	number	Nombre d'abonnés
`image_url`	string	URL de l'image de profil
`external_url`	string	URL Spotify

`spotify_get_top_tracks`

Obtenir l'utilisateur actuel

Entrée

Paramètre	Type	Obligatoire	Description
`time_range`	string	Non	Période : short_term (~4 semaines), medium_term (~6 mois), long_term (années)
`limit`	number	Non	Nombre de pistes à retourner (1-50)
`offset`	number	Non	Index de la première piste à retourner

Sortie

Paramètre	Type	Description
`tracks`	array	Utilisateur

`spotify_get_top_artists`

Obtenir l'utilisateur actuel

Entrée

Paramètre	Type	Obligatoire	Description
`time_range`	string	Non	Période : short_term (~4 semaines), medium_term (~6 mois), long_term (années)
`limit`	number	Non	Nombre d'artistes à retourner (1-50)
`offset`	number	Non	Index du premier artiste à retourner

Sortie

Paramètre	Type	Description
`artists`	array	Utilisateur

`spotify_get_saved_tracks`

Obtenir l'utilisateur actuel

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	number	Non	Nombre de pistes à retourner (1-50)
`offset`	number	Non	Index de la première piste à retourner
`market`	string	Non	Code pays ISO 3166-1 alpha-2

Sortie

Paramètre	Type	Description
`tracks`	array	Utilisateur

`spotify_save_tracks`

Enregistrer des pistes pour l'utilisateur actuel

Entrée

Paramètre	Type	Obligatoire	Description
`trackIds`	string	Oui	IDs de pistes Spotify séparés par des virgules à enregistrer (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Si les pistes ont été enregistrées avec succès

`spotify_remove_saved_tracks`

Supprimer des pistes de l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`trackIds`	string	Oui	IDs de pistes séparés par des virgules à supprimer (max 50)

Sortie

Paramètre	Type	Description
`success`	boolean	Si les pistes ont été supprimées avec succès

`spotify_check_saved_tracks`

Vérifier si une ou plusieurs pistes sont enregistrées chez l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`trackIds`	string	Oui	IDs de pistes séparés par des virgules à vérifier (max 50)

Sortie

Paramètre	Type	Description
`results`	json	Tableau d'IDs de pistes avec leur statut d'enregistrement
`all_saved`	boolean	Si toutes les pistes sont enregistrées
`none_saved`	boolean	Si aucune piste n'est enregistrée

`spotify_get_recently_played`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`limit`	number	Non	Nombre de pistes à retourner (1-50)
`after`	number	Non	Timestamp Unix en millisecondes. Renvoie les éléments après ce curseur.
`before`	number	Non	Timestamp Unix en millisecondes. Renvoie les éléments avant ce curseur.

Sortie

Paramètre	Type	Description
`items`	array	Pistes écoutées récemment

`spotify_get_new_releases`

Obtenir une liste des nouvelles sorties d'albums mises en avant sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`country`	string	Non	Code pays ISO 3166-1 alpha-2 (ex., "US", "GB")
`limit`	number	Non	Nombre de sorties à retourner (1-50)
`offset`	number	Non	Index de la première sortie à retourner

Sortie

Paramètre	Type	Description
`albums`	json	Liste des nouvelles sorties
`total`	number	Nombre total de nouvelles sorties
`next`	string	URL pour la page suivante

`spotify_get_categories`

Obtenir une liste des catégories de navigation utilisées pour étiqueter les éléments dans Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`country`	string	Non	Code pays ISO 3166-1 alpha-2 (ex., "US", "GB")
`locale`	string	Non	Code de langue (ex., "en_US", "es_MX")
`limit`	number	Non	Nombre de catégories à retourner (1-50)

Sortie

Paramètre	Type	Description
`categories`	json	Liste des catégories de navigation
`total`	number	Nombre total de catégories

`spotify_get_markets`

Obtenir la liste des marchés où Spotify est disponible.

Entrée

Paramètre	Type	Obligatoire	Description

Sortie

Paramètre	Type	Description
`markets`	json	Liste des codes pays ISO

`spotify_get_playback_state`

Obtenir l'état de lecture actuel, y compris l'appareil, la piste et la progression.

Entrée

Paramètre	Type	Obligatoire	Description
`market`	string	Non	Code pays ISO 3166-1 alpha-2

Sortie

Paramètre	Type	Description
`is_playing`	boolean	Si la lecture est active
`device`	object	Informations sur l'appareil actif
`progress_ms`	number	Progression en millisecondes
`currently_playing_type`	string	Type de contenu en lecture
`shuffle_state`	boolean	Si la lecture aléatoire est activée
`repeat_state`	string	Mode de répétition (off, track, context)
`track`	object	Piste en cours de lecture

`spotify_get_currently_playing`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`market`	string	Non	Code pays ISO pour le marché

Sortie

Paramètre	Type	Description
`is_playing`	boolean	Indique si la lecture est active
`progress_ms`	number	Position actuelle dans la piste (ms)
`track`	json	Piste en cours de lecture

`spotify_get_devices`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description

Sortie

Paramètre	Type	Description
`devices`	array	Appareils de lecture disponibles

`spotify_get_queue`

Obtenir l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description

Sortie

Paramètre	Type	Description
`currently_playing`	json	Piste en cours de lecture
`queue`	json	Pistes à venir dans la file d'attente

`spotify_play`

Démarrer ou reprendre la lecture sur Spotify. Peut lire des pistes, albums ou playlists spécifiques.

Entrée

Paramètre	Type	Obligatoire	Description
`device_id`	string	Non	ID de l'appareil sur lequel lancer la lecture. Si non fourni, la lecture se fait sur l'appareil actif.
`context_uri`	string	Non	URI Spotify de l'album, artiste ou playlist à lire (ex. : "spotify:album:xxx")
`uris`	string	Non	URIs des pistes séparées par des virgules à lire (ex. : "spotify:track:xxx,spotify:track:yyy")
`offset`	number	Non	Position dans le contexte pour commencer la lecture (index basé sur 0)
`position_ms`	number	Non	Position dans la piste pour commencer (en millisecondes)

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si la lecture a démarré avec succès

`spotify_pause`

Mettre en pause la lecture sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`device_id`	string	Non	ID de l'appareil à mettre en pause. Si non fourni, met en pause l'appareil actif.

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si la lecture a été mise en pause

`spotify_skip_next`

Passer à la piste suivante sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`device_id`	string	Non	ID de l'appareil. Si non fourni, utilise l'appareil actif.

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si le passage à la piste suivante a réussi

`spotify_skip_previous`

Revenir à la piste précédente sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`device_id`	string	Non	ID de l'appareil. Si non fourni, utilise l'appareil actif.

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si le retour à la piste précédente a réussi

`spotify_seek`

Se positionner à un moment précis dans la piste en cours de lecture.

Entrée

Paramètre	Type	Obligatoire	Description
`position_ms`	number	Oui	Position en millisecondes vers laquelle se déplacer
`device_id`	string	Non	ID de l'appareil ciblé

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si le déplacement a réussi

`spotify_add_to_queue`

Ajouter une piste à l'utilisateur

Entrée

Paramètre	Type	Obligatoire	Description
`uri`	string	Oui	URI Spotify de la piste à ajouter (ex. : "spotify:track:xxx")
`device_id`	string	Non	ID de l'appareil. Si non fourni, utilise l'appareil actif.

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si la piste a été ajoutée à la file d'attente

`spotify_set_volume`

Régler le volume de lecture sur Spotify.

Entrée

Paramètre	Type	Obligatoire	Description
`volume_percent`	number	Oui	Niveau de volume (0 à 100)
`device_id`	string	Non	ID de l'appareil. Si non fourni, utilise l'appareil actif.

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si le volume a été réglé

`spotify_set_repeat`

Définir le mode de répétition pour la lecture.

Entrée

Paramètre	Type	Obligatoire	Description
`state`	string	Oui	Mode répétition : "off", "track" ou "context"
`device_id`	string	Non	ID de l'appareil ciblé

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si le mode répétition a été défini avec succès

`spotify_set_shuffle`

Activer ou désactiver la lecture aléatoire.

Entrée

Paramètre	Type	Obligatoire	Description
`state`	boolean	Oui	true pour activer la lecture aléatoire, false pour la désactiver
`device_id`	string	Non	ID de l'appareil ciblé

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si la lecture aléatoire a été définie avec succès

`spotify_transfer_playback`

Transférer la lecture vers un autre appareil.

Entrée

Paramètre	Type	Obligatoire	Description
`device_id`	string	Oui	ID de l'appareil vers lequel transférer la lecture
`play`	boolean	Non	Indique s'il faut démarrer la lecture sur le nouvel appareil

Sortie

Paramètre	Type	Description
`success`	boolean	Indique si le transfert a réussi

Notes

Catégorie : tools
Type : spotify

On this page

On this page

Instructions d'utilisation

spotify_search

spotify_get_track

spotify_get_tracks

spotify_get_album

spotify_get_albums

spotify_get_album_tracks

spotify_get_saved_albums

spotify_save_albums

spotify_remove_saved_albums

spotify_check_saved_albums

spotify_get_artist

spotify_get_artists

spotify_get_artist_albums

spotify_get_artist_top_tracks

spotify_follow_artists

spotify_unfollow_artists

spotify_get_followed_artists

spotify_check_following

spotify_get_show

spotify_get_shows

spotify_get_show_episodes

spotify_get_saved_shows

spotify_save_shows

spotify_remove_saved_shows

spotify_check_saved_shows

spotify_get_episode

spotify_get_episodes

spotify_get_saved_episodes

spotify_save_episodes

spotify_remove_saved_episodes

spotify_check_saved_episodes

spotify_get_audiobook

spotify_get_audiobooks

spotify_get_audiobook_chapters

spotify_get_saved_audiobooks

spotify_save_audiobooks

spotify_remove_saved_audiobooks

spotify_check_saved_audiobooks

spotify_get_playlist

spotify_get_playlist_tracks

spotify_get_playlist_cover

spotify_get_user_playlists

spotify_create_playlist

spotify_update_playlist

spotify_add_playlist_cover

spotify_add_tracks_to_playlist

spotify_remove_tracks_from_playlist

spotify_reorder_playlist_items

spotify_replace_playlist_items

spotify_follow_playlist

spotify_unfollow_playlist

spotify_check_playlist_followers

spotify_get_current_user

spotify_get_user_profile

spotify_get_top_tracks

spotify_get_top_artists

spotify_get_saved_tracks

spotify_save_tracks

spotify_remove_saved_tracks

spotify_check_saved_tracks

spotify_get_recently_played

spotify_get_new_releases

spotify_get_categories

spotify_get_markets

spotify_get_playback_state

spotify_get_currently_playing

spotify_get_devices

spotify_get_queue

spotify_pause

spotify_skip_next

spotify_skip_previous

spotify_add_to_queue

spotify_set_volume

spotify_set_repeat

spotify_set_shuffle

spotify_transfer_playback

Start building today

Trusted by over 60,000 builders.

Build Agentic workflows visually on a drag-and-drop canvas or with natural language.