Skip to content

Latest commit

 

History

History
113 lines (77 loc) · 2.93 KB

README.markdown

File metadata and controls

113 lines (77 loc) · 2.93 KB
Raw

Spotify PHP API

About

A simple static PHP wrapper for Spotify's Metadata API.
Your feedback is always welcome.

Requirements

  • PHP 5.2.x or higher
  • cURL

Get started

Setup class and search for an Artist

<?php
    require_once 'spotify.class.php';
        
    // Search for an artist by its name
    $artist = Spotify::searchArtist('Maroon 5');
        
    // Take a look at the response
    echo '<pre>';
    print_r($artist);
    echo '<pre>';
?>

URI Lookup

<?php
    // Look up for an artist by its Spotify URI
    Spotify::lookup('spotify:artist:58lV9VcRSjABbAbfWS6skp', 'album');
?>

Generate Spotify URI

<?php
    // Search for a track
    $track = Spotify::searchTrack('Narcotic');
        
    // Receive the Spotify URI for the first track
    $uri = Spotify::getUri($track); // spotify:track:6MSPmHR15vgpa0A5L205Xv
        
    // Display Spotify link (opens Spotify player)
    echo "<a href="/{$uri}"/>Play Song with Spotify</a>";
?>

All methods return the API data json_decode() - so you can directly access the data.

Available methods

Search methods

  • searchArtist($name, <$page>)
  • searchAlbum($title, <$page>)
  • searchTrack($title, <$page>)

All <$page> parameters are optional. If the page number is undefined, the first one will be returned (default).

Sample responses of the Search Endpoints.

Lookup method

  • lookup($uri, <$detail>)
    • $uri is a valid Spotify URI like: spotify:artist:58lV9VcRSjABbAbfWS6skp, spotify:track:4I4BS0OeI7VZdo5WeEQHFP
      • the URI type will be automatically detected
    • $detail defines the detail level in the response. Possible options are:
      • Artist: album, albumdetail
      • Album: track, trackdetail
      • Track: no detail level available
  • getUri($obj, <$count>)
    • $obj is a JSON object returned by one of the search methods
    • $count [optional] number of result (first result = 0 [default])

Sample responses of the Lookup Endpoints.

If you need additional informations, take a look at Spotify's API docs.

History

Spotify 1.2 - 04/01/2013

  • bug Fixed undeclared static property error
  • update Updated Spotify API doc URLs

Spotify 1.1 - 12/12/2011

  • feature Changed class to static methods
  • update Adjusted documentation
  • change Removed default constructor

Spotify 1.0 - 27/11/2011

  • release First official released version
  • feature Added getUri() method
  • update Detailed documentation

Spotify 0.5 - 26/11/2011

  • release Beta version
  • update Small documentation

Credits

Copyright (c) 2011 - Programmed by Christian Metz
Released under the BSD License.