Audiosear.ch PHP Client

PHP client SDK for https://www.audiosear.ch/

See docs at https://www.audiosear.ch/developer/

OAuth credentials are available from https://www.audiosear.ch/oauth/applications

Example:

require_once 'path/to/Audiosearch/Client.php';

# create a client
$client = new Audiosearch_Client(array(
  'key'     => 'oauth_id',
  'secret'  => 'oauth_secret',
  'host'    => 'https://www.audiosear.ch',
  'debug'   => false,
));

# fetch a show with id 1234
$show = $client->get('/shows/1234');
# or more idiomatically
$show = $client->get_show(1234);

# fetch an episode
$episode = $client->get('/episodes/5678');
# or idiomatically
$episode = $client->get_episode(5678);

# get related content for an episode or show
$related = $client->get_related(15, array('type' => 'shows', 'size' => 5, 'from' => 5)); # id is required, type: 'episodes' is default

# search
$res = $client->search(array('q' => 'test'));
foreach($res->results as $episode) {
  printf("[%s] %s (%s)\n", $episode->id, $episode->title, $episode->show_title);
}

# tastemakers
$recs = $client->get_tastemakers(array('n' => '5')); # 'type' => 'episodes' is the default, may also specify 'type' => 'shows'

# trending
$trends = $client->get_trending();

# person
$person = $client->get_person(1578)

Development

This package uses composer. To install dependencies you'll need the composer tool from https://getcomposer.org/. Then:

make install

To run the tests, create a .env file in the checkout with the following environment variables set to meaningful values:

AS_ID=somestring
AS_SECRET=sekritstring
AS_HOST=http://audiosear.ch.dev

Then run the tests:

make test