무료 음악 조회 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]으로 문의하세요.
웹 페이지에서 호출할 수 있나요?
네, 코드로 조회하는 GET 요청은 가능합니다. 열린 CORS 헤더를 보냅니다. 링크는 POST 본문에 담아야 하므로 그 부분은 직접 운영하는 서버에서 호출하세요.
코드마다 고정 페이지가 있는 이유는 무엇인가요?
모든 응답에는 pageUrl이 들어 있습니다. 해당 코드를 위한 wbbt.net의 공개 페이지입니다. 사람들이 전체 정보를 보게 하고 싶다면 이 페이지를 링크하세요.