Spotify Web API PHP

This is a PHP implementation of the Spotify Web API. It includes the following:

• Helper methods for all API methods (Information about artists, albums and tracks).
• Search the Spotify catalog.
• Get information about users and their music library.
• Manage playlists for users.
• Authorization flow helpers.
• PSR-4 autoloading support.

Requirements

PHP 5.3 or greater.

Installation

1. If you're already using Composer then you'll just need to include jwilsson/spotify-web-api-php as a dependency. Otherwise, download the library and include the files.
2. Create a new app at https://developer.spotify.com/
3. Enter your app credentials.
4. Call the API!

Usage

Depending on the API methods you're planning on using you can choose between authenticating the user or just go.

Authenticating a user

Using Authorization Code Flow

require 'vendor/autoload.php';

$session = new SpotifyWebAPI\Session('CLIENT_ID', 'CLIENT_SECRET', 'REDIRECT_URI');

// Get the authorization URL and send the user there
header('Location: ' . $session->getAuthorizeUrl(array('scope' => array('scope-1', 'scope-2'))));

When receiving a request back to your redirect URI:

require 'vendor/autoload.php';

$session = new SpotifyWebAPI\Session('CLIENT_ID', 'CLIENT_SECRET', 'REDIRECT_URI');
$api = new SpotifyWebAPI\SpotifyWebAPI();

// Request a access token using the code from Spotify
$session->requestToken($_GET['code']);
$accessToken = $session->getAccessToken(); // We're good to go!

// Set the code on the API wrapper
$api->setAccessToken($accessToken);

Using Client Credentials Flow

require 'vendor/autoload.php';

$session = new SpotifyWebAPI\Session('CLIENT_ID', 'CLIENT_SECRET', 'REDIRECT_URI');

// Request a access token with optional scopes
$session->requestCredentialsToken(array('scope-1', 'scope-2'));
$accessToken = $session->getAccessToken(); // We're good to go!

// Set the code on the API wrapper
$api->setAccessToken($accessToken);

Making API calls

$track = $api->getTrack('7EjyzZcbLxW7PaaLua9Ksb');

print_r($track);

More examples

Add tracks to a user's library

$api->addMyTracks(array('1oR3KrPIp4CbagPa3PhtPp', '6lPb7Eoon6QPbscWbMsk6a'));

Add tracks to a user's playlist

$api->addUserPlaylistTracks('username', 'playlist_id', array('1oR3KrPIp4CbagPa3PhtPp', '6lPb7Eoon6QPbscWbMsk6a'));

Create a new playlist for a user

$api->createUserPlaylist('username', array('name' => 'My shiny playlist'));

Delete tracks from a user's library

$api->deleteMyTracks(array('1oR3KrPIp4CbagPa3PhtPp', '6lPb7Eoon6QPbscWbMsk6a'));

Delete tracks from a user's playlist

$tracks = array(
    array('id' => '1oR3KrPIp4CbagPa3PhtPp'),
    array('id' => '6lPb7Eoon6QPbscWbMsk6a')
);

$api->deletePlaylistTracks('username', 'playlist_id', $tracks, 'snapshot_id');

Get a album

$album = $api->getAlbum('7u6zL7kqpgLPISZYXNTgYk');

print_r($album);

Get multiple albums

$albums = $api->getAlbums(array('1oR3KrPIp4CbagPa3PhtPp', '6lPb7Eoon6QPbscWbMsk6a'));

print_r($albums);

Get all tracks from an album

$tracks = $api->getAlbumTracks('1oR3KrPIp4CbagPa3PhtPp');

print_r($tracks);

Get an artist

$artist = $api->getArtist('36QJpDe2go2KgaRleHCDTp');

print_r($artist);

Get an artist's related artists

$artists = $api->getArtistRelatedArtists('36QJpDe2go2KgaRleHCDTp');

print_r($artists);

Get multiple artists

$artists = $api->getArtists(array('6v8FB84lnmJs434UJf2Mrm', '6olE6TJLqED3rqDCT0FyPh'));

print_r($artists);

Get all albums by an artist

$albums = $api->getArtistAlbums('6v8FB84lnmJs434UJf2Mrm');

print_r($albums);

Get an artist's top tracks in a country

$tracks = $api->getArtistTopTracks('6v8FB84lnmJs434UJf2Mrm', 'se');

print_r($tracks);

Get Spotify featured playlists

$playlists = $api->getFeaturedPlaylists();

print_r($playlists);

Get new releases

$items = $api->getNewReleases(array(
    'country' => 'se'
));

print_r($items);

Get a user's saved tracks

$tracks = $api->getMySavedTracks();

print_r($tracks);

Get a track

$track = $api->getTrack('7EjyzZcbLxW7PaaLua9Ksb');

print_r($track);

Get multiple tracks

$tracks = $api->getTracks(array('0eGsygTp906u18L0Oimnem', '1lDWb6b6ieDQ2xT7ewTC3G'));

print_r($tracks);

Get a user

$user = $api->getUser('username');

print_r($user);

Get a user's playlists

$playlists = $api->getUserPlaylists('username');

print_r($playlists);

Get a specific playlist

$playlist = $api->getUserPlaylist('username', '606nLQuR41ZaA2vEZ4Ofb8');

print_r($playlist);

Get all tracks in a user's playlist

$tracks = $api->getUserPlaylistTracks('username', '606nLQuR41ZaA2vEZ4Ofb8');

print_r($tracks);

Get the currently authenticated user

$user = $api->me();

print_r($user);

See if a user's tracks contains the specified tracks

$contains = $api->myTracksContains(array('0eGsygTp906u18L0Oimnem', '1lDWb6b6ieDQ2xT7ewTC3G'));

var_dump($contains);

Replace all tracks in a user's playlist with new ones

$api->replacePlaylistTracks('username', 'playlist_id', array('0eGsygTp906u18L0Oimnem', '1lDWb6b6ieDQ2xT7ewTC3G'));

Search for an album

$albums = $api->search('blur', 'album');

print_r($albums);

Search for an artist

$artists = $api->search('blur', 'artist');

print_r($artists);

Search for a track

$tracks = $api->search('song 2', 'track');

print_r($tracks);

Search with a limit

$tracks = $api->search('song 2', 'track', array(
    'limit' => 5
));

print_r($tracks);

Search for tracks in a specific market

$tracks = $api->search('song 2', 'track', array(
    'market' => 'se'
));

print_r($tracks);

Update a user's playlist

$api->updateUserPlaylist('username', 'playlist_id', array('name' => 'New name'));

Browse through src/spotifywebapi.php and look at the tests for more methods and examples.