https://github.com/jwilsson/spotify-web-api-php

A PHP wrapper for Spotify's Web API.
https://github.com/jwilsson/spotify-web-api-php

php spotify

Last synced: 7 days ago
JSON representation

A PHP wrapper for Spotify's Web API.

• Host: GitHub
• URL: https://github.com/jwilsson/spotify-web-api-php
• Owner: jwilsson
• License: mit
• Created: 2014-06-17T19:57:07.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2025-01-18T06:46:37.000Z (19 days ago)
• Last Synced: 2025-01-23T02:03:45.512Z (14 days ago)
• Topics: php, spotify
• Language: PHP
• Homepage:
• Size: 1.94 MB
• Stars: 871
• Watchers: 37
• Forks: 156
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Spotify Web API PHP

[![Packagist](https://img.shields.io/packagist/v/jwilsson/spotify-web-api-php.svg)](https://packagist.org/packages/jwilsson/spotify-web-api-php)

![build](https://github.com/jwilsson/spotify-web-api-php/workflows/build/badge.svg)

[![Coverage Status](https://coveralls.io/repos/jwilsson/spotify-web-api-php/badge.svg?branch=main)](https://coveralls.io/r/jwilsson/spotify-web-api-php?branch=main)

This is a PHP wrapper for [Spotify's Web API](https://developer.spotify.com/web-api/). It includes the following:

* Helper methods for all API endpoints:

    * Information about artists, albums, tracks, podcasts, audiobooks, and users.

    * List music featured by Spotify.

    * Playlist and user music library management.

    * Spotify catalog search.

    * User playback control.

* Authorization flow helpers.

* Automatic refreshing of access tokens.

* Automatic retry of rate limited requests.

* PSR-4 autoloading support.

## Requirements

* PHP 8.1 or later.

* PHP [cURL extension](http://php.net/manual/en/book.curl.php) (Usually included with PHP).

## Installation

Install it using [Composer](https://getcomposer.org/):

```sh

composer require jwilsson/spotify-web-api-php

```

## Usage

Before using the Spotify Web API, you'll need to create an app at [Spotify’s developer site](https://developer.spotify.com/web-api/).

*Note: Applications created after 2021-05-27 [might need to perform some extra steps](https://developer.spotify.com/community/news/2021/05/27/improving-the-developer-and-user-experience-for-third-party-apps/).*

Simple example displaying a user's profile:

```php

require 'vendor/autoload.php';

$session = new SpotifyWebAPI\Session(

    'CLIENT_ID',

    'CLIENT_SECRET',

    'REDIRECT_URI'

);

$api = new SpotifyWebAPI\SpotifyWebAPI();

if (isset($_GET['code'])) {

    $session->requestAccessToken($_GET['code']);

    $api->setAccessToken($session->getAccessToken());

    print_r($api->me());

} else {

    $options = [

        'scope' => [

            'user-read-email',

        ],

    ];

    header('Location: ' . $session->getAuthorizeUrl($options));

    die();

}

```

For more instructions and examples, check out the [documentation](/docs/).

The [Spotify Web API Console](https://developer.spotify.com/web-api/console/) can also be of great help when trying out the API.

## Contributing

Contributions are more than welcome! See [CONTRIBUTING.md](/CONTRIBUTING.md) for more info.

## License

MIT license. Please see [LICENSE.md](LICENSE.md) for more info.