Spotify Recommendations APIのまとめ

Spotify Recommendations API

個人的にめちゃくちゃハマってしまったのでメモ的な記事。

概要

Spotify Recommendatinos APIとは:Spotifyのおすすめ機能をAPI活用できるものである。

参照

実践

まずアクセストークンを取得する。

Spotify Developer Portalで新しいアプリを作成し、Client IdとClient Secretを入手する。

以下にPOSTリクエストを飛ばす。HTTPヘッダーのContent-Typeにapplication/x-www-form-urlencodedを指定する。

参照

https://accounts.spotify.com/api/token?grant_type=client_credentials&client_id=メモったClient Id&client_secret=メモったClient Secret

返ってきた結果はこんな風になってるはず。

{
    "access_token": "BQBr0Xsnz-省略-8Cvbj81wQ",
    "token_type": "Bearer",
    "expires_in": 3600
}

expires_inというのは有効期限であり、このトークンは1時間でアクセスが切れる。そのため、1時間毎に更新する（というか新しいものを入手する）必要がある。

では、トークンを入手したので次におすすめ情報を入手する。

以下のURLにGETリクエストを送る。

https://api.spotify.com/v1/recommendations?limit=10&market=ES&seed_tracks=5Iy2Jj87Ha0C0IBlNE1I4y

なお、Authorizationヘッダーに

Bearer  さっきのトークン

を指定すること。Bearerとトークンの間に2つスペースを入れる必要がある。

解説
（以下はクエリ名）
limit:最大で何個おすすめが欲しいか。何も書かなければ20、マックスは100
market:市場。国コードで指定するか何も書かない
seed_tracks:トラックのID。例えば
[https://open.spotify.com/intl-ja/track/5Iy2Jj87Ha0C0IBlNE1I4y]
だったら5Iy2Jj87Ha0C0IBlNE1I4yになる。コンマ区切りで最大5つまで指定できる
seed_artists:アーティストのID。コンマ区切り、5個まで
seed_genres:ジャンルのID。コンマ区切り、5個まで

seed_tracks、seed_artists、seed_genresに関してはどれか一つは最低必要。