Spotify Web APIを利用して指定したアーティストに関連するアーティスト情報を取得することができる。関連アーティストというのは、類似するアーティストのことで、Spotifyがコミュニティの視聴履歴データを元に割り出している。また、特定のアーティストに対して、取得できる関連アーティストは最大20アーティストまでとなる。
下記は、関連アーティスト情報を取得するコードの例。
class SpotifyApiClient
{
private $rootEndpoint = 'https://api.spotify.com/v1/';
private $accessToken;
public function __construct($ACCESS_TOKEN)
{
$this->accessToken = $ACCESS_TOKEN;
}
public function get($path, array $queryParams)
{
$url = $this->rootEndpoint . $path;
if (!empty($queryParams))
$url .= '?' . http_build_query($queryParams);
$response = $this->execCurlGET($url);
sleep(1);
return json_decode($response, true);
}
private function execCurlGET($url)
{
$cmd = 'curl' .
" -H 'Authorization: Bearer {$this->accessToken}'" .
" '$url'";
echo "# $cmd\n";
return shell_exec($cmd);
}
}
$tokenFile = 'token_new.json';
$token = json_decode(file_get_contents($tokenFile), true);
$client = new SpotifyApiClient($token['access_token']);
$artistId = '64tJ2EAv1R6UaZqc4iOCyj'; // YOASOBI
$response = $client->get("artists/$artistId/related-artists", []);
var_dump($response);
関連アーティスト情報を取得するAPIリクエストは、下記URL
https://api.spotify.com/v1/artists/{id}/related-artists
に対してGETリクエストを行えば良い。このとき、パスのパラメータ id
にアーティストIDを指定する。
APIレスポンスとして、指定したアーティストIDに関連するアーティスト情報が返される。その件数は最大で20件までとなる。
また、関連アーティスト情報は、レスポンスデータの artists
キーに入っている。