A simple PHP class to query the Beatport Catalog API.
The use case is for a server to server context - for example I used it to build a simple Beatport RSS feed for my label. NB: The class requests an access token each time it's instantiated and doesn't try to persist it to e.g. DB for later use.
It returns an array which you can then manipulate as you please.
- Login and query the Beatport Catalog API
- Send back a simple array with the query results
- PHP 7.3+
- Beatport API Credentials (You'll need to request those from Beatport)
- Guzzle 7 (via composer)
composer require moussaclarke/beatportapi
use MoussaClarke\BeatportApi;
// auth parameters
$parameters = [
'client_id'=> 'CLIENT_ID', // Your Beatport Client Id
'client_secret' => 'CLIENT_SECRET', // Your Beatport Client Secret
];
// query parameters
$query = [
'label_id' => 'xyz', // a filter facet
'resource' => 'releases', // The Beatport API resource to query
'perPage' => '150' // Number of results per page
];
$api = new BeatportApi ($parameters); // initialise
$response = $api->queryApi ($query); // run the query
print_r ($response); // do something with response
You can check the Beatport API documentation for which queries you can make and which parameters are required.
Totally and utterly alpha, and likely to break at any point. Not guaranteed to work as intended in any way, so use at your own risk.
- Handle errors
- Support other bits of the API, e.g. curation
Feel free to submit bug reports, suggestions and pull requests. Alternatively just fork it and make your own thing.
MIT
Outside of geekdom, I'm a DJ, producer and label manager, go check me out: