PHPackages                             sdksio/spotify-api-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. sdksio/spotify-api-sdk

ActiveLibrary[API Development](/categories/api)

sdksio/spotify-api-sdk
======================

You can use Spotify's Web API to discover music and podcasts, manage your Spotify library, control audio playback, and much more. Browse our available Web API endpoints using the sidebar at left, or via the navigation bar on top of this page on smaller screens.

1.0.0(1y ago)012MITPHPPHP ^7.2 || ^8.0

Since Aug 23Pushed 1y agoCompare

[ Source](https://github.com/sdks-io/spotify-api-php-sdk)[ Packagist](https://packagist.org/packages/sdksio/spotify-api-sdk)[ Docs](https://spotify-poc.pages.dev/)[ RSS](/packages/sdksio-spotify-api-sdk/feed)WikiDiscussions main Synced yesterday

READMEChangelogDependencies (5)Versions (2)Used By (0)

Getting Started with Spotify Web API
====================================

[](#getting-started-with-spotify-web-api)

Introduction
------------

[](#introduction)

You can use Spotify's Web API to discover music and podcasts, manage your Spotify library, control audio playback, and much more. Browse our available Web API endpoints using the sidebar at left, or via the navigation bar on top of this page on smaller screens.

In order to make successful Web API requests your app will need a valid access token. One can be obtained through [OAuth 2.0](https://developer.spotify.com/documentation/general/guides/authorization-guide/).

The base URI for all Web API requests is `https://api.spotify.com/v1`.

Need help? See our [Web API guides](https://developer.spotify.com/documentation/web-api/guides/) for more information, or visit the [Spotify for Developers community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer) to ask questions and connect with other developers.

Install the Package
-------------------

[](#install-the-package)

Run the following command to install the package and automatically add the dependency to your composer.json file:

```
composer require "sdksio/spotify-api-sdk:1.0.0"
```

Or add it to the composer.json file manually as given below:

```
"require": {
    "sdksio/spotify-api-sdk": "1.0.0"
}
```

You can also view the package at:

Initialize the API Client
-------------------------

[](#initialize-the-api-client)

***Note:*** Documentation for the client can be found [here.](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/client.md)

The following parameters are configurable for the API Client:

ParameterTypeDescription`environment``Environment`The API environment.
 **Default: `Environment.PRODUCTION`**`timeout``int`Timeout for API calls in seconds.
*Default*: `0``enableRetries``bool`Whether to enable retries and backoff feature.
*Default*: `false``numberOfRetries``int`The number of retries to make.
*Default*: `0``retryInterval``float`The retry time interval between the endpoint calls.
*Default*: `1``backOffFactor``float`Exponential backoff factor to increase interval between retries.
*Default*: `2``maximumRetryWaitTime``int`The maximum wait time in seconds for overall retrying requests.
*Default*: `0``retryOnTimeout``bool`Whether to retry on request timeout.
*Default*: `true``httpStatusCodesToRetry``array`Http status codes to retry against.
*Default*: `408, 413, 429, 500, 502, 503, 504, 521, 522, 524``httpMethodsToRetry``array`Http methods to retry against.
*Default*: `'GET', 'PUT'``authorizationCodeAuth`[`AuthorizationCodeAuth`](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/auth/oauth-2-authorization-code-grant.md)The Credentials Setter for OAuth 2 Authorization Code GrantThe API client can be initialized as follows:

```
$client = SpotifyWebAPIClientBuilder::init()
    ->authorizationCodeAuthCredentials(
        AuthorizationCodeAuthCredentialsBuilder::init(
            'OAuthClientId',
            'OAuthClientSecret',
            'OAuthRedirectUri'
        )
            ->oAuthScopes(
                [
                    OAuthScopeEnum::APP_REMOTE_CONTROL,
                    OAuthScopeEnum::PLAYLIST_READ_PRIVATE
                ]
            )
    )
    ->environment('production')
    ->build();
```

API calls return an `ApiResponse` object that includes the following fields:

FieldDescription`getStatusCode`Status code of the HTTP response`getHeaders`Headers of the HTTP response as a Hash`getResult`The deserialized body of the HTTP response as a StringAuthorization
-------------

[](#authorization)

This API uses the following authentication schemes.

- [`oauth_2_0 (OAuth 2 Authorization Code Grant)`](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/auth/oauth-2-authorization-code-grant.md)

List of APIs
------------

[](#list-of-apis)

- [Albums](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/albums.md)
- [Artists](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/artists.md)
- [Audiobooks](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/audiobooks.md)
- [Categories](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/categories.md)
- [Chapters](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/chapters.md)
- [Episodes](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/episodes.md)
- [Genres](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/genres.md)
- [Markets](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/markets.md)
- [Player](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/player.md)
- [Playlists](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/playlists.md)
- [Search](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/search.md)
- [Shows](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/shows.md)
- [Tracks](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/tracks.md)
- [Users](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/controllers/users.md)

Classes Documentation
---------------------

[](#classes-documentation)

- [ApiException](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/api-exception.md)
- [HttpRequest](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/http-request.md)
- [HttpResponse](https://www.github.com/sdks-io/spotify-api-php-sdk/tree/1.0.0/doc/http-response.md)

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

679d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef06f97b4ff5db714f2a124525216538f97338487cd4e2bca22baa32c0bf90cd?d=identicon)[developer-sdksio](/maintainers/developer-sdksio)

---

Top Contributors

[![developer-sdksio](https://avatars.githubusercontent.com/u/135820708?v=4)](https://github.com/developer-sdksio "developer-sdksio (1 commits)")

---

Tags

apisdkapimaticspotify

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/sdksio-spotify-api-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/sdksio-spotify-api-sdk/health.svg)](https://phpackages.com/packages/sdksio-spotify-api-sdk)
```

###  Alternatives

[square/square

Use Square APIs to manage and run business including payment, customer, product, inventory, and employee management.

773.9M29](/packages/square-square)[paypal/paypal-server-sdk

PayPal's SDK for interacting with the REST APIs

62833.4k13](/packages/paypal-paypal-server-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)