無料の音楽照会API
ISRC、UPC、ストアのリンクを調べて、整ったJSONを受け取れます。キーもアカウントも不要です。無料ツールと同じ公開ソースを使っています。
APIが返すもの
照会APIは、録音コード(ISRC)、バーコード(UPCまたはEAN)、Apple Musicのリンクの先にあるリリースを返します。タイトル、アーティスト、アルバム、リリース日、レーベル、著作権表示、関連コードが含まれます。どの応答にも、データソースと短い出典表示の文が付きます。
結果は公開データベースから取得するため、新しいリリースや小規模なカタログは載っていないことがあります。結果がないことは、コードが間違っている証拠にはなりません。
データの使い方
応答ごとに付くソース名を表示し、Powered by WBBTの行を見える状態に保ってください。データを完全なものとして、または録音の所有者を示す証拠として扱わないでください。
SpotifyのリンクはAPIでは受け付けていません。このサイトの無料ツールに貼り付けてください。
使用例
コードで調べる
クエリ文字列にisrcまたはupcを入れてGETリクエストを送ります。公開されているコードなので、アドレスに入れても問題ありません。
curl "https://wbbt.net/api/v1/lookup?isrc=USABC2400001"
const res = await fetch("https://wbbt.net/api/v1/lookup?upc=036000291452");
const json = await res.json();
if (json.ok) console.log(json.data.result.title, json.poweredBy);リンクで調べる
ストアのリンクには追跡用のパラメーターが付いていることがあります。アドレスではなく、POSTのJSON本文に入れて送ってください。
curl -X POST https://wbbt.net/api/v1/lookup \
-H "Content-Type: application/json" \
-d '{"url":"https://music.apple.com/us/album/example-album/1234567890"}'応答
どの応答にもok、version、data、sources、attribution、poweredByがあります。値のないフィールドはnullです。
{
"ok": true,
"version": "1",
"data": {
"type": "recording",
"query": { "isrc": "USABC2400001" },
"results": [
{
"title": "Night Drive",
"artist": "Luna Vale",
"album": null,
"releaseDate": "2024-05-17",
"isrcs": ["USABC2400001"],
"isrcMatch": "exact",
"upc": null,
"label": null,
"distributedByWbbt": false,
"pageUrls": { "isrc": "https://wbbt.net/isrc/USABC2400001", "upc": null }
}
]
},
"sources": [{ "name": "MusicBrainz", "url": "https://musicbrainz.org", "attribution": "Data from MusicBrainz (CC0)." }],
"cached": false,
"poweredBy": "Powered by WBBT Records (https://wbbt.net/tools/api)"
}制限
- アドレスごとに毎分30件、毎日1000件のリクエスト。
- 応答は数分間、その元になるデータは最長で丸一日キャッシュされることがあります。
- キーは不要です。制限は変わることがあり、versionフィールドで受け取るスキーマが分かります。
エラー
- 400 invalid_request: コードがない、形式が正しくない、またはチェックディジットが合っていません。
- 404 not_found: このコードでは何も見つかりませんでした。
- 422 unsupported_link: Apple Musicのリンクではありません。
- 429 rate_limited: Retry-Afterヘッダーに書かれた秒数だけ待ってください。
- 503 unavailable: データソースが混み合っています。少し待ってからお試しください。
出典表示
応答ごとに示されたソースを表示し、Powered by WBBTの行を残してください。wbbt.net/tools/apiへのリンクがあるとありがたいです。
よくある質問
APIキーは必要ですか?
いいえ。APIは公開されていてキーは不要で、アドレスごとに制限されます。さらに多くのリクエストが必要な場合は、[email protected]までご連絡ください。
Webページから呼び出せますか?
はい、コードで調べるGETリクエストなら可能です。公開のCORSヘッダーを返します。リンクはPOSTの本文に入れるので、その部分はご自身のサーバーから呼び出してください。
コードごとに固定ページがあるのはなぜですか?
どの応答にもpageUrlが含まれます。そのコードのためのwbbt.net上の公開ページです。詳しい情報を見てほしいときは、このページにリンクしてください。