Last FM class

Possible Methods

__construct

Default constructor

Parameters

apiKey string (optional)
secret string (optional)

Return

void

Example

<?php
// require
require_once 'last_fm.php';

// create instance
$lastfm = new LastFm('<your-api-key>', '<your-secret>');

// no token? authorize the app
if(!isset($_GET['token'])) $lastfm->auth('<your-callback-url>');

// get session
$response = $lastfm->authGetSession($_GET['token']);

// output, you can use the key for setSessionKey
var_dump($response);
?>

getAPIKey

Get the API key

Return

string

getSecret

Get the secret

Return

string

setAPIKey

Set the API key

Parameters

apiKey string

Return

void

setSecret

Set the secret

Parameters

secret string

Return

void

setSessionKey

Set the session key

Parameters

key string

Return

void

setTimeOut

Set the timeout

Parameters

seconds int

Return

void

setUserAgent

Set the user-agent for you application
It will be appended to ours

Parameters

useragent

Return

void

albumAddTags

Tag an album using a list of user supplied tags.

Parameters

artist string
The artist name in question
album string
The album name in question
tags array
An array of user supplied tags to apply to this album. Accepts a maximum of 10 tags.

Return

bool

Get a list of Buy Links for a particular Album.
It is required that you supply either the artist and album params or the mbid param.

Parameters

artist string (optional)
The artist name in question.
album string (optional)
The album in question.
mbid string (optional)
A MusicBrainz id for the album in question.
country string (optional)
A country name, as defined by the ISO 3166-1 country names standard.

Return

array

albumGetInfo

Get the metadata for an album on Last.fm using the album name or a musicbrainz id.
See playlistFetch on how to get the album playlist.

Parameters

artist string (optional)
The artist name in question
album string (optional)
The album name in question
mbid string (optional)
The musicbrainz id for the album
username string (optional)
The username for the context of the request. If supplied, the user's playcount for this album is included in the response.
lang string (optional)
The language to return the biography in, expressed as an ISO 639 alpha-2 code.

Return

array

Example

<?php
// require
require_once 'last_fm.php';

// create instance
$lastfm = new LastFm('<your-api-key>', '<your-secret>');

// set key
$lastfm->setSessionKey('<your-session-key>');

// get info about an album
$response = $lastfm->albumGetInfo('skillet', 'comatose');

// output
var_dump($response);
?>

albumGetTags

Get the tags applied by an individual user to an album on Last.fm.

Parameters

artist string
The artist name in question
album string
The album name in question

Return

array

albumRemoveTag

Remove a user's tag from an album.

Parameters

artist string
The artist name in question
album string
The album name in question
tag string
A single user tag to remove from this album

Return

array

albumSearch

Search for an album by name. Returns album matches sorted by relevance.

Parameters

album string
The album name in question.
limit int (optional)
Limit the number of albums returned at one time. Default (maximum) is 30.
page int (optional)
Scan into the results by specifying a page number. Defaults to first page.

Return

array

albumShare

Share an album with one or more Last.fm users or other friends.

Parameters

artist string
The artist name in question
album string
The album name in question
recipients array
An array of email addresses or Last.fm usernames. Maximum is 10.
public bool (optional)
Optionally show in the sharing users activity feed.
message string (optional)
An optional message to send with the recommendation. If not supplied a default message will be used.

Return

array

artistAddTags

Tag an artist with one or more user supplied tags.

Parameters

artist string
The artist name in question.
tags array
An array of user supplied tags to apply to this artist. Accepts a maximum of 10 tags.

Return

bool

artistGetEvents

Get a list of upcoming events for this artist.
Easily integratable into calendars, using the ical standard.

Parameters

artist string
The artist name in question

Return

array

artistGetImages

Get Images for this artist in a variety of sizes.

Parameters

artist string
The artist name in question.
limit int (optional)
How many to return. Defaults and maxes out at 50.
page int (optional)
Which page of limit amount to display.
order string (optional)
Sort ordering can be either 'popularity' (default) or 'dateadded'. While ordering by popularity officially selected images by labels and artists will be ordered first.

Return

array

artistGetInfo

Get the metadata for an artist on Last.fm. Includes biography.

Parameters

artist string (optional)
The artist name in question
mbid string (optional)
The musicbrainz id for the artist
username string (optional)
The username for the context of the request. If supplied, the user's playcount for this artist is included in the response.
lang string (optional)
The language to return the biography in, expressed as an ISO 639 alpha-2 code.

Return

array

artistGetPastEvents

Get a paginated list of all the events this artist has played at in the past.

Parameters

artist string
The name of the artist you would like to fetch event listings for.
limit int (optional)
The maximum number of results to return per page
page int (optional)
The page of results to return.

Return

array

artistGetPodcast

Get a podcast of free mp3s based on an artist

Parameters

artist string
The artist name in question

Return

array

artistGetShouts

Get shouts for this artist.

Parameters

artist string
The artist name in question.
limit int (optional)
An integer used to limit the number of shouts returned per page. The default is 50.
page int (optional)
The page number to fetch.

Return

array

artistGetSimilar

Get all the artists similar to this artist

Parameters

artist string
The artist name in question
limit int (optional)
Limit the number of similar artists returned

Return

array

artistGetTags

Get the tags applied by an individual user to an artist on Last.fm.

Parameters

artist string

Return

array

artistGetTopAlbums

Get the top albums for an artist on Last.fm, ordered by popularity.

Parameters

artist string
The artist name in question

Return

array

artistGetTopFans

Get the top fans for an artist on Last.fm, based on listening data.

Parameters

artist string
The artist name in question

Return

array

artistGetTopTags

Get the top tags for an artist on Last.fm, ordered by popularity.

Parameters

artist string
The artist name in question

Return

array

artistGetTopTracks

Get the top tracks by an artist on Last.fm, ordered by popularity

Parameters

artist string
The artist name in question

Return

array

artistRemoveTag

Remove a user's tag from an artist.

Parameters

artist string
The artist name in question.
tag string
A single user tag to remove from this artist.

Return

bool

artistSearch

Search for an artist by name. Returns artist matches sorted by relevance.

Parameters

artist string
The artist name in question.
limit int (optional)
Limit the number of artists returned at one time. Default (maximum) is 30.
page int (optional)
Scan into the results by specifying a page number. Defaults to first page.

Return

array

artistShare

Share an artist with Last.fm users or other friends.

Parameters

artist string
The artist to share.
recipients array
An array of email addresses or Last.fm usernames. Maximum is 10.
public bool (optional)
Show in the sharing users activity feed. Defaults to false.
message string (optional)
An optional message to send with the recommendation. If not supplied a default message will be used.

Return

bool

artistShout

Shout in this artist's shoutbox

Parameters

artist string
The name of the artist to shout on.
message string
The message to post to the shoutbox.

Return

bool

authGetMobileSession

Create a web service session for a user. Used for authenticating a user when the password can be inputted by the user.
Only suitable for standalone mobile devices. See the authentication how-to for more.

Parameters

username string
The last.fm username.
password string
The last.fm password

Return

array

authGetSession

Fetch a session key for a user.
The third step in the authentication process. See the authentication how-to for more information.

Parameters

token string
A 32-character ASCII hexadecimal MD5 hash returned by step 1 of the authentication process (following the granting of permissions to the application by the user).

Return

array

authGetToken

Fetch an unathorized request token for an API account.
This is step 2 of the authentication process for desktop applications. Web applications do not need to use this service.

Return

string

eventAttend

Set a user's attendance status for an event.

Parameters

event string
The numeric last.fm event id
status int
The attendance status, possible values are: 0 = Attending, 1 = Maybe attending, 2 = Not attending.

Return

bool

eventGetAttendees

Get a list of attendees for an event.

Parameters

event string
The numeric last.fm event id

Return

array

eventGetInfo

Get the metadata for an event on Last.fm. Includes attendance and lineup information.

Parameters

event string
The numeric last.fm event id

Return

array

eventGetShouts

Get shouts for this event.

Parameters

event string
The numeric last.fm event id

Return

array

eventShare

Share an event with one or more Last.fm users or other friends.

Parameters

event string
An event ID
recipients array
An array of email addresses or Last.fm usernames. Maximum is 10.
public bool (optional)
Optionally show the share in the sharing users recent activity. Defaults to false.
message string (optional)
An optional message to send with the recommendation. If not supplied a default message will be used.

Return

bool

eventShout

Shout in this event's shoutbox

Parameters

event string
The id of the event to shout on
message string
The message to post to the shoutbox

Return

bool

geoGetEvents

Get all events in a specific location by country or city name.

Parameters

location string (optional)
Specifies a location to retrieve events for (service returns nearby events by default)
lat string (optional)
Specifies a latitude value to retrieve events for (service returns nearby events by default)
long string (optional)
Specifies a longitude value to retrieve events for (service returns nearby events by default)
distance string (optional)
Find events within a specified radius (in kilometres)
page int (optional)
Display more results by pagination

Return

array

geoGetMetroArtistChart

Get a chart of artists for a metro

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
metro string
The metro's name
start string (optional)
Beginning timestamp of the weekly range requested.
end string (optional)
Ending timestamp of the weekly range requested.

Return

array

geoGetMetroHypeArtistChart

Get a chart of hyped (up and coming) artists for a metro

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
metro string
The metro's name
start string (optional)
Beginning timestamp of the weekly range requested.
end string (optional)
Ending timestamp of the weekly range requested.

Return

array

geoGetMetroHypeTrackChart

Get a chart of tracks for a metro

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
metro string
The metro's name
start string (optional)
Beginning timestamp of the weekly range requested.
end string (optional)
Ending timestamp of the weekly range requested.

Return

array

geoGetMetroTrackChart

Get a chart of tracks for a metro

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
metro string
The metro's name
start string (optional)
Beginning timestamp of the weekly range requested.
end string (optional)
Ending timestamp of the weekly range requested.

Return

array

geoGetMetroUniqueArtistChart

Get a chart of the artists which make that metro unique

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
metro string
The metro's name
start string (optional)
Beginning timestamp of the weekly range requested.
end string (optional)
Ending timestamp of the weekly range requested.

Return

array

geoGetMetroUniqueTrackChart

Get a chart of tracks for a metro

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
metro string
The metro's name
start string (optional)
Beginning timestamp of the weekly range requested.
end string (optional)
Ending timestamp of the weekly range requested.

Return

array

geoGetMetroWeeklyChartlist

Get a list of available chart periods for this metro, expressed as date ranges which can be sent to the chart services.

Return

array

geoGetTopArtists

Get the most popular artists on Last.fm by country

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard

Return

array

geoGetTopTracks

Get the most popular tracks on Last.fm last week by country

Parameters

country string
A country name, as defined by the ISO 3166-1 country names standard
location string (optional)
A metro name, to fetch the charts for (must be within the country specified)

Return

array

groupGetMembers

Get a list of members for this group.

Parameters

group string
The group name to fetch the members of.

Return

array

groupGetWeeklyAlbumChart

Get an artist chart for a group, for a given date range. If no date range is supplied, it will return the most recent album chart for this group.

Parameters

group string
The last.fm group name to fetch the charts of.
from string
The date at which the chart should start from.
to string
The date at which the chart should end on.

Return

array

groupGetWeeklyArtistChart

Get an artist chart for a group, for a given date range. If no date range is supplied, it will return the most recent album chart for this group.

Parameters

group string
The last.fm group name to fetch the charts of.
from string
The date at which the chart should start from.
to string
The date at which the chart should end on.

Return

array

groupGetWeeklyChartList

Get a list of available charts for this group, expressed as date ranges which can be sent to the chart services.

Parameters

group string
The last.fm group name to fetch the charts list for.

Return

array

groupGetWeeklyTrackChart

Get a track chart for a group, for a given date range. If no date range is supplied, it will return the most recent album chart for this group.

Parameters

group string
The last.fm group name to fetch the charts of.
from string
The date at which the chart should start from.
to string
The date at which the chart should end on.

Return

array

libraryAddAlbum

Add an album to a user's Last.fm library

Parameters

artist string
The artist that composed the track.
album string
The album name you wish to add.

Return

bool

libraryAddArtist

Add an artist to a user's Last.fm library

Parameters

artist string
The artist that composed the track

Return

bool

libraryAddTrack

Add a track to a user's Last.fm library

Parameters

artist string
The artist that composed the track
track string
The track name you wish to add

Return

bool

libraryGetAlbums

A paginated list of all the albums in a user's library, with play counts and tag counts.

Parameters

username string
The user whose library you want to fetch.
artist string (optional)
An artist by which to filter tracks.
limit int (optional)
Limit the amount of tracks returned (maximum/default is 50).
page int (optional)
The page number you wish to scan to.

Return

array

libraryGetArtists

A paginated list of all the artists in a user's library, with play counts and tag counts.

Parameters

username string
The user whose library you want to fetch.
limit int (optional)
Limit the amount of artists returned (maximum/default is 50).
page int (optional)
The page number you wish to scan to.

Return

array

libraryGetTracks

A paginated list of all the tracks in a user's library, with play counts and tag counts.

Parameters

username string
The user whose library you want to fetch.
artist string (optional)
An artist by which to filter tracks.
album string (optional)
An album by which to filter tracks (needs an artist).
limit int (optional)
Limit the amount of tracks returned (maximum/default is 50).
page int (optional)
The page number you wish to scan to.

Return

array

playlistAddTrack

Add a track to a Last.fm user's playlist

Parameters

playlistID string
The ID of the playlist - this is available in user.getPlaylists.
artist string
The artist name that corresponds to the track to be added.
track string
The track name to add to the playlist.

Return

bool

playlistCreate

Create a Last.fm playlist on behalf of a user

Parameters

title string (optional)
Title for the playlist
description string (optional)
Description for the playlist

Return

array

playlistFetch

Fetch XSPF playlists using a lastfm playlist url.

Parameters

playlistURL string
A lastfm protocol playlist url ('lastfm://playlist/...') . See 'playlists' section for more information.

Return

array

radioGetPlaylist

Fetch new radio content periodically in an XSPF format.

Parameters

discovery bool (optional)
Whether to request last.fm content with discovery mode switched on.
rtp bool (optional)
Whether the user is scrobbling or not during this radio session (helps content generation).
bitrate int (optional)
What bitrate to stream content at, in kbps (supported bitrates are 64 and 128).
buyLinks bool (optional)
Whether the response should contain links for purchase/download, if available (default false).
speedMultiplier string (optional)
The rate at which to provide the stream (supported multipliers are 1.0 and 2.0).

Return

array

radioTune

Tune in to a Last.fm radio station.

Parameters

station string
A lastfm radio URL
lang string (optional)
An ISO language code to determine the language to return the station name in, expressed as an ISO 639 alpha-2 code.

Return

array

tagGetSimilar

Search for tags similar to this one. Returns tags ranked by similarity, based on listening data.

Parameters

tag string
The tag name in question.

Return

array

tagGetTopAlbums

Get the top albums tagged by this tag, ordered by tag count.

Parameters

tag string
The tag name in question.

Return

array

tagGetTopArtists

Get the top artists tagged by this tag, ordered by tag count.

Parameters

tag string
The tag name in question.

Return

array

tagGetTopTags

Fetches the top global tags on Last.fm, sorted by popularity (number of times used)

Return

array

tagGetTopTracks

Get the top tracks tagged by this tag, ordered by tag count.

Parameters

tag string
The tag name in question.

Return

array

tagGetWeeklyArtistChart

Get an artist chart for a tag, for a given date range. If no date range is supplied, it will return the most recent artist chart for this tag.

Parameters

tag string
The tag name in question.
from string (optional)
The date at which the chart should start from.
to string (optional)
The date at which the chart should end on.
limit int (optional)
The number of chart items to return. Default is 50.

Return

array

tagGetWeeklyChartList

Get a list of available charts for this tag, expressed as date ranges which can be sent to the chart services.

Parameters

tag string
The tag name in question.

Return

array

tagSearch

Search for a tag by name. Returns matches sorted by relevance.

Parameters

tag string
The tag name in question.
limit int (optional)
Limit the number of tags returned at one time. Default (maximum) is 30.
page int (optional)
Scan into the results by specifying a page number. Defaults to first page.

Return

array

tasteometerCompare

Get a Tasteometer score from two inputs, along with a list of shared artists. If the input is a User or a Myspace URL, some additional information is returned.

Parameters

type1 string
The type for the first user, possible values are: user, artists, myspace.
type2 string
The type for the second user, possible values are: user, artists, myspace.
value1 mixed
The value for the first user, possible values are: Last.fm-username, array of artist-names, myspace profile url.
value2 mixed
The value for the second user, possible values are: Last.fm-username, array of artist-names, myspace profile url.
limit int (optional)
How many shared artists to display. Default is 5.

Return

array

trackAddTags

Tag a track using a list of user supplied tags.

Parameters

artist string
The artist name in question
track string
The track name in question
tags array
An array of user supplied tags to apply to this track. Accepts a maximum of 10 tags.

Return

bool

trackBan

Ban a track for a given user profile.
This needs to be supplemented with a scrobbling submission containing the 'ban' rating (see the audioscrobbler API).

Parameters

artist string
An artist name
track string
A track name

Return

bool

Get a list of Buy Links for a particular Track. It is required that you supply either the artist and track params or the mbid param.

Parameters

artist string (optional)
The artist name in question.
track string (optional)
The track name in question.
mbid string (optional)
A MusicBrainz id for the album in question.
country string (optional)
A country name, as defined by the ISO 3166-1 country names standard.

Return

array

trackGetInfo

Get the metadata for a track on Last.fm using the artist/track name or a musicbrainz id.

Parameters

artist string (optional)
The artist name in question
track string (optional)
The track name in question
mbid string (optional)
The musicbrainz id for the track
username string (optional)
The username for the context of the request. If supplied, the user's playcount for this track and whether they have loved the track is included in the response.

Return

array

trackGetSimilar

Get the similar tracks for this track on Last.fm, based on listening data.

Parameters

artist string (optional)
The artist name in question
track string (optional)
The track name in question
mbid string (optional)
The musicbrainz id for the track

Return

array

trackGetTags

Get the tags applied by an individual user to a track on Last.fm.

Parameters

artist string
The artist name in question
track string
The track name in question

Return

array

trackGetTopFans

Get the top fans for this track on Last.fm, based on listening data. Supply either track & artist name or musicbrainz id.

Parameters

artist string (optional)
The artist name in question
track string (optional)
The track name in question
mbid string (optional)
The musicbrainz id for the track

Return

array

trackGetTopTags

Get the top tags for this track on Last.fm, ordered by tag count. Supply either track & artist name or mbid.

Parameters

artist string (optional)
The artist name in question
track string (optional)
The track name in question
mbid string (optional)
The musicbrainz id for the track

Return

array

trackLove

Love a track for a user profile. This needs to be supplemented with a scrobbling submission containing the 'love' rating (see the audioscrobbler API).

Parameters

artist string
A track name
track string
An artist name

Return

bool

trackRemoveTag

Remove a user's tag from a track.

Parameters

artist string
The artist name in question
track string
The track name in question
tag string
A single user tag to remove from this track.

Return

bool

trackSearch

Search for a track by track name. Returns track matches sorted by relevance.

Parameters

track string
The track name in question.
artist string (optional)
Narrow your search by specifying an artist.
limit int (optional)
Limit the number of tracks returned at one time. Default (maximum) is 30.
page int (optional)
Scan into the results by specifying a page number. Defaults to first page.

Return

array

trackShare

Share an artist with Last.fm users or other friends.

Parameters

artist string
The artist to share.
track string
A track name.
recipients array
An array of email addresses or Last.fm usernames. Maximum is 10.
public bool (optional)
Show in the sharing users activity feed. Defaults to false.
message string (optional)
An optional message to send with the recommendation. If not supplied a default message will be used.

Return

bool

userGetArtistTracks

Get a list of tracks by a given artist scrobbled by this user, including scrobble time. Can be limited to specific timeranges, defaults to all time.

Parameters

username string
The last.fm username to fetch the recent tracks of.
artist string
The artist name you are interested in
start int (optional)
An unix timestamp to start at.
end int (optional)
An unix timestamp to end at.
page int (optional)
An integer used to fetch a specific page of tracks.

Return

array

userGetEvents

Get a list of upcoming events that this user is attending.

Parameters

username string
The user to fetch the events for.

Return

array

userGetFriends

Get a list of the user's friends on Last.fm.

Parameters

username string
The last.fm username to fetch the friends of.
recentTracks bool (optional)
Whether or not to include information about friends' recent listening in the response.
limit int (optional)
An integer used to limit the number of friends returned per page. The default is 50.
page int (optional)
The page number to fetch.

Return

array

userGetInfo

Get information about a user profile.
@todo check http://www.last.fm/api/show?service=344

Parameters

username string
The last.fm username to fetch the friends of.

Return

array

userGetLovedTracks

Get the last 50 tracks loved by a user.

Parameters

username string
The user name to fetch the loved tracks for.
limit int (optional)
An integer used to limit the number of tracks returned per page. The default is 50.
page int (optional)
The page number to fetch.

Return

array

userGetNeighbours

Get a list of a user's neighbours on Last.fm.

Parameters

username string
The last.fm username to fetch the neighbours of.
limit int (optional)
An integer used to limit the number of neighbours returned.

Return

array

userGetPastEvents

Get a paginated list of all events a user has attended in the past.

Parameters

username string
The username to fetch the events for.
limit int (optional)
The maximum number of events to return per page.
page int (optional)
The page number to scan to.

Return

string

userGetPlaylists

Get a list of a user's playlists on Last.fm.

Parameters

username string
The last.fm username to fetch the playlists of.

Return

array

userGetRecentStations

Get a list of the recent Stations listened to by this user.

Parameters

username string
The last.fm username to fetch the recent Stations of.
limit int (optional)
An integer used to limit the number of stations returned per page. The default is 10, the maximum is 25
page int (optional)
The page number to fetch.

Return

array

userGetRecentTracks

Get a list of the recent tracks listened to by this user.

Parameters

username string
The last.fm username to fetch the recent tracks of.
limit int (optional)
An integer used to limit the number of tracks returned.
page int (optional)
An integer used to fetch a specific page of tracks
nowPlaying bool (optional)
Includes the currently playing track with the nowplaying="true" attribute if the user is currently listening.

Return

array

userGetRecommendedArtists

Get Last.fm artist recommendations for a user

Return

array

userGetRecommendedEvents

Get a paginated list of all events recommended to a user by Last.fm, based on their listening profile.

Parameters

limit int (optional)
The number of events to return per page.
page int (optional)
The page number to scan to.

Return

array

userGetShouts

Get shouts for this user.

Parameters

username string
The user name to fetch shouts for.

Return

array

userGetTopAlbums

Get the top albums listened to by a user. You can stipulate a time period. Sends the overall chart by default.

Parameters

username
period string (optional)
The time period over which to retrieve top albums for, possible values are: overall, 7day, 3month, 6month, 12month.

Return

array

userGetTopArtists

Get the top artists listened to by a user. You can stipulate a time period. Sends the overall chart by default.

Parameters

username
period string (optional)
The time period over which to retrieve top artists for: overall, 7day, 3month, 6month, 12month.

Return

array

userGetTopTags

Parameters

username string
The user name
limit int (optional)
Limit the number of tags returned

Return

array

userGetTopTracks

Get the top tracks listened to by a user. You can stipulate a time period. Sends the overall chart by default.

Parameters

username
period string (optional)
The time period over which to retrieve top tracks for: overall, 7day, 3month, 6month, 12month.

Return

array

userGetWeeklyAlbumChart

Get an album chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent album chart for this user.

Parameters

username string
The last.fm username to fetch the charts of.
from string (optional)
The date at which the chart should start from.
to string (optional)
The date at which the chart should end on.

Return

array

userGetWeeklyArtistChart

Get an artist chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent artist chart for this user.

Parameters

username string
The last.fm username to fetch the charts of.
from string (optional)
The date at which the chart should start from.
to string (optional)
The date at which the chart should end on.

Return

array

userGetWeeklyChartList

Get a list of available charts for this user, expressed as date ranges which can be sent to the chart services.

Parameters

username string
The last.fm username to fetch the charts list for.

Return

array

userGetWeeklyTrackChart

Get a track chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent track chart for this user.

Parameters

username string
The last.fm username to fetch the charts of.
from string (optional)
The date at which the chart should start from.
to string (optional)
The date at which the chart should end on.

Return

array

userShout

Shout on this user's shoutbox

Parameters

username string
The name of the user to shout on.
message string
The message to post to the shoutbox.

Return

bool

venueGetEvents

Get a list of upcoming events at this venue.

Parameters

venue string
The id for the venue you would like to fetch event listings for.

Return

array

venueGetPastEvents

Get a paginated list of all the events held at this venue in the past.

Parameters

venue string
The id for the venue you would like to fetch event listings for.
limit int (optional)
The maximum number of results to return per page.
page int (optional)
The page of results to return.

Return

array

venueSearch

Search for a venue by venue name

Parameters

venue string
The venue name you would like to search for.
limit int (optional)
The number of results to fetch per page. Defaults to 50.
page int (optional)
The results page you would like to fetch
country string (optional)
Filter your results by country. Expressed as an ISO 3166-2 code.

Return

array

auth

Parameters

callbackURL

Return

About me?

Well, I'm Tijs Verkoyen, a self employed Belgian PHP-developer at Sumo Coders.

If you want to know more about me, check my blog (Dutch).

If you really like my work and want to support me, feel free to use the donate-button below.

Spoon

At both companies, we use Spoon. Spoon is a PHP5 Library that we use for building all our Web 2.0 applications.

The classes that you can download from this website are standalone, so each developer is free to use a library/framework/… he likes best.