Last.fm 是一個知名的網路電台跟音樂社群,在八九年前左右非常活躍,雖然現在因為有更多收聽音樂的方式跟選擇,但他的使用者依然相當多。
Last.fm API 提供在 Last.fm 平台上的各種資料,比方說專輯、創作者、標籤、使用者跟歌曲的資料。
先來註冊一個 API Key:
今天就來試用他的 geo.getTopTracks
功能。
首先,所有 API 的 URL 都基於
http://ws.audioscrobbler.com/2.0/
這個 geo.getTopTracks
可以抓到指定國家上週在 last.fm 平台上最受歡迎的歌曲,那他的完整 URL 如下:
'GET', "http://ws.audioscrobbler.com/2.0/?method=geo.gettoptracks
&country=spain
&api_key=YOUR_API_KEY
&format=json"
必要的參數有
country
: 國家名稱api_key
可選的參數有
location
:在指定國家內更精確的地點limit
:每頁結果數量,預設是 50page
:回傳的頁數,預設是第一頁在寫一個基本的 XHR 之後,
var apiKey = "10841853e5ac190a3e4ec2beae95a6f0";
var url = "https://ws.audioscrobbler.com/2.0/?method=geo.gettoptracks&country=taiwan&api_key="+apiKey+"&format=json";
function makeRequest() {
xhr = new XMLHttpRequest();
xhr.onload = function() {
var response = JSON.parse(this.responseText);
console.log(response);
};
xhr.open("GET", url, true);
xhr.send();
}
makeRequest();
得到以下 response
然後把 response 寫進 HTML 裏: