概要
Spotify APIを使用して色々な楽曲のデータなど取得するための手順をまとめました。
API叩いてデータを取得するところまでが今回のゴールになります。
対象者
- PHP使っている方
- Dockerを使用している方
- APIからデータ取得してみたいという方
手順
準備
準備1. アカウントIDとキーを確認する
Spotify APIを使用する際にはアカウントを登録する必要があります。
（フリープランでもOK！）
登録後、開発者用ダッシュボードにアクセスしてIDとキーを取得します。
※このIDとキーが肝です。
App nameとか色々と入力する項目があるかと思いますが、一旦適当に入力しておくので大丈夫です。
準備2. PHPの準備 
ここからはDockerでPHPの準備をしていきます。
DockerでPHPを使うまでの手順は省略します。
簡単にAPIからデータを取得できるよう、 spotify-web-api-php を使用していきますので、その前にComposerを準備しておいてください。
Composerが準備できましたらspotify-web-api-phpを入れていきましょう。
service名の部分はご自身の環境に合わせて直してください。
docker-compose exec (service名) composer require jwilsson/spotify-web-api-php
コマンドが通ってvendorフォルダができていれば準備OKです。
さっそくデータを取得していきましょう！
データ取得
1.アクセストークンの準備
適当にindex.phpなどのファイルを作成し、準備段階で確認した固有のIDとclient secretをセットしていきます。
<?
require_once('./vendor/autoload');
$session = new SpotifyWebAPI\Session(
'準備1で確認したID',
'準備1で確認したclient secret'
);
$api = new SpotifyWebAPI\SpotifyWebAPI();
$session->requestCredentialsToken();
$accessToken = $session->getAccessToken();
$api->setAccessToken($accessToken);
2. 各種データの取得
// アーティストを検索
$result = $api->search('weezer', 'artist');
echo json_encode($result);
こんな感じでデータが返ってきます。長いので省略していますが、アーティストの画像やジャンルなんかが取得できています。
詳細についはSpotify公式やspotify-web-api-phpのドキュメントなんかを読むと良いです。
{
- artists:
{
- href: "[https://api.spotify.com/v1/search?query=weezer&type=artist&offset=0&limit=20](https://api.spotify.com/v1/search?query=weezer&type=artist&offset=0&limit=20)",
- items:
[
- {
- external_urls:
{
- spotify: "[https://open.spotify.com/artist/3jOstUTkEu2JkjvRdBA5Gu](https://open.spotify.com/artist/3jOstUTkEu2JkjvRdBA5Gu)"
},
- followers:
{
- href: null,
- total: 3790877
},
- genres:
[
- "alternative rock",
- "modern power pop",
- "modern rock",
- "permanent wave",
- "rock"
],
- href: "[https://api.spotify.com/v1/artists/3jOstUTkEu2JkjvRdBA5Gu](https://api.spotify.com/v1/artists/3jOstUTkEu2JkjvRdBA5Gu)",
- id: "3jOstUTkEu2JkjvRdBA5Gu",
- images:
[
- {
- height: 640,
- url: "[https://i.scdn.co/image/ab6761610000e5eb3cd35451daa1b690cfbbb2d4](https://i.scdn.co/image/ab6761610000e5eb3cd35451daa1b690cfbbb2d4)",
- width: 640
},
- {
- height: 320,
- url: "[https://i.scdn.co/image/ab676161000051743cd35451daa1b690cfbbb2d4](https://i.scdn.co/image/ab676161000051743cd35451daa1b690cfbbb2d4)",
- width: 320
},
- {
- height: 160,
- url: "[https://i.scdn.co/image/ab6761610000f1783cd35451daa1b690cfbbb2d4](https://i.scdn.co/image/ab6761610000f1783cd35451daa1b690cfbbb2d4)",
- width: 160
}
],
- name: "Weezer",
(このあとにも色々データが続きます。今回は省略。)
続けてアルバム情報を取得してみましょう。先程取得したアーティスト情報の中からアーティストIDを使用して、そのアーティストに紐づくアルバム情報を取得してみようと思います。
// アルバム
$result = $api->getArtistAlbums('3jOstUTkEu2JkjvRdBA5Gu', ['include_groups' => 'album', 'limit' => 5]);
echo json_encode($result);
index.phpを見てみましょう。
{
- href: "[https://api.spotify.com/v1/artists/3jOstUTkEu2JkjvRdBA5Gu/albums?offset=0&limit=5&include_groups=album](https://api.spotify.com/v1/artists/3jOstUTkEu2JkjvRdBA5Gu/albums?offset=0&limit=5&include_groups=album)",
- limit: 5,
- next: "[https://api.spotify.com/v1/artists/3jOstUTkEu2JkjvRdBA5Gu/albums?offset=5&limit=5&include_groups=album](https://api.spotify.com/v1/artists/3jOstUTkEu2JkjvRdBA5Gu/albums?offset=5&limit=5&include_groups=album)",
- offset: 0,
- previous: null,
- total: 406,
- items:
[
- {
- album_type: "album",
- total_tracks: 28,
- available_markets:
[],
- external_urls:
{
- spotify: "[https://open.spotify.com/album/2WJsNhU7H0rZQzWdMVQ4NV](https://open.spotify.com/album/2WJsNhU7H0rZQzWdMVQ4NV)"
},
- href: "[https://api.spotify.com/v1/albums/2WJsNhU7H0rZQzWdMVQ4NV](https://api.spotify.com/v1/albums/2WJsNhU7H0rZQzWdMVQ4NV)",
- id: "2WJsNhU7H0rZQzWdMVQ4NV",
- images:
[],
- name: "SZNZ: Winter",
- release_date: "2022-12-21",
- release_date_precision: "day",
- type: "album",
- uri: "spotify:album:2WJsNhU7H0rZQzWdMVQ4NV",
- artists:
[],
- album_group: "album"
},
(省略)
取得できましたね！（取得データは長いので今回も省略します。）
今回はこれで以上です。
色々とデータが取得できて面白いですね。
公式ドキュメントを読んでみるとどんなデータが取得できているのかわかりますし、ライブラリのドキュメントからもどんなデータが取得できるのか確認できます。
音楽データの分析？なんかもされている方もいるみたいです。
一度目を通して見られてはいかがでしょうか。