maniadb open api

1. Request
url: http://www.maniadb.com/api/search/[keyword]/?sr=[artist|album|song]&display=[1~100]&key=[apikey]&v=[version]
example: http://www.maniadb.com/api/search/metallica/?sr=artist&display=10&key=example&v=0.5
http://www.maniadb.com/api/search/metallica/?sr=album&display=10&key=example&v=0.5
http://www.maniadb.com/api/search/metallica/?sr=song&display=10&key=example&v=0.5
parametertypedescription
keywordstring (not null)검색어 (utf-8 encoding)
sr string (not null)검색대상 (default:artist, range:artist,album,song)
displayinteger (not null)검색결과 출력건수 (default:10, range:1~100)
keystring (not null)api key
vstring (not null)api version (default:0.5)
1. api key 는 당분간 validation check를 하진 않습니다. 본인의 이메일을 key 로 사용하고 계시면, 정책 변경시 연락 드리겠습니다. 언제 정책이 바뀔지 모르므로, 연락이 닿지 않을 경우 예고 없이 사용이 중단될 수 있습니다.
2. 아래 CCL 의 조건을 준수하여 사용하시면 되고, 상업적 사용의 경우 이메일로 연락 바랍니다.
2. Response (XML)
parametertypedescription
rss string디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
... channel string검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다.
... ... lastBuildDatedatetime검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다.
... ... total integer검색 결과 문서의 총 개수를 의미합니다.
... ... start integer검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다.
... ... display integer검색된 검색 결과의 개수입니다.
... ... item -개별 검색 결과이며, title, link을 포함합니다.
... ... ... -귀찮아서 정리하지 못했습니다. 예제를 보세요.
 
1. Request
url: http://www.maniadb.com/api/album/[album_id]/?key=[apikey]
example: http://www.maniadb.com/api/album/712017/?key=example&v=0.5
parametertypedescription
album_idstring (not null)maniadb album_id
keystring (not null)api key
vstring (not null)api version (default:0.5)
2. Response (XML)
parametertypedescription
rss string디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
... channel string앨범 정보를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다.
... ... lastBuildDatedatetime앨범 정보를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다.
... ... item -앨범 정보를 보여주는 컨테이너로, 하나만 존재합니다. title, link을 포함합니다. 파라메터 id는 maniadb album_id를 의미합니다.
... ... ... -귀찮아서 정리하지 못했습니다. 예제를 보세요.
 
1. Request
요청 변수 설명
key string (필수) 이용 등록을 통해 받은 key 스트링을 입력합니다.
target string (필수) music
itemtype string (필수) 검색 대상 : album, artist
query string 검색어 : UTF-8 인코딩 입니다.
display integer : 기본값 10, 최대 100 검색결과 출력건수 : 최대 100까지 가능합니다.
2. Response (XML)
요청 변수 설명
rss - 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
... channel - 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다.
... ... lastBuildDate datetime 검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다.
... ... total integer 검색 결과 문서의 총 개수를 의미합니다.
... ... start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다.
... ... display integer 검색된 검색 결과의 개수입니다.
... ... item - 개별 검색 결과이며, title, link을 포함합니다.
3-1. 출력 결과 필드 : ALBUM
문서를 귀찮아서 안 만들었습니다. 틈나는대로 만들께요. 일단 예제를 보세요.

  • (호출예)
    http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.4&itemtype=album&query=metallica
3-2. 출력 결과 필드 : SONG
아직 못 만들었습니다.

  • (호출예)
    http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.4&itemtype=song&query=metallica
3-3. 출력 결과 필드 : ARTIST
문서를 귀찮아서 안 만들었습니다. 틈나는대로 만들께요. 일단 예제를 보세요.

  • (호출예)
    http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.4&itemtype=artist&query=metallica
 
1. Request
url: http://www.maniadb.com/api/search.asp?v=0.3&target=[music]&itemtype=[artist|album|song]&option=[artist|album|song]&query=[keyword]&key=[apikey]
example: http://www.maniadb.com/api/search.asp?v=0.3&target=music&itemtype=artist&option=artist&query=white&key=example
요청 변수 설명
key string (필수) 이용 등록을 통해 받은 key 스트링을 입력합니다.
target string (필수) 서비스를 위해서는 무조건 지정해야 합니다.
ex) music, ...
itemtype string (필수) 서비스를 위해서는 무조건 지정해야 합니다.
ex) album, song, artist, ...
option string (필수) 검색 기준을 선택합니다.
ex) album, song, artist, ...
query string 검색을 원하는 앨범의 이름, UTF-8 인코딩 입니다.
option2 string 두번째 검색 기준을 선택합니다.
ex) artist, ....
query2 string 검색을 원하는 아티스트의 이름, UTF-8 인코딩 입니다.
display integer : 기본값 10, 최대 100 검색결과 출력건수를 지정합니다. 최대 100까지 가능합니다.
2. Response (XML)
요청 변수 설명
rss - 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
... channel - 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다.
... ... lastBuildDate datetime 검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다.
... ... total integer 검색 결과 문서의 총 개수를 의미합니다.
... ... start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다.
... ... display integer 검색된 검색 결과의 개수입니다.
... ... item - 개별 검색 결과이며, title, link을 포함합니다.
요청 변수 설명
... ... item - 개별 검색 결과이며, title, link을 포함합니다. 파라메터 id는 maniadb album_id를 의미합니다.
... ... ... title string 앨범 제목을 나타냅니다.
... ... ... release string 앨범 발매일자를 char(8) 형태로 나타냅니다.
... ... ... link string 앨범 링크를 나타냅니다.
... ... ... image string 앨범 커버를 나타냅니다. 최대 800x800으로 구성됩니다.
... ... ... description string 앨범 소개글이 나타냅니다. 최대 100글자로 구성됩니다.
... ... ... maniadb:artist - 앨범의 대표 아티스트 정보를 나타냅니다.
... ... ... ... link string 앨범의 아티스트 링크를 나타냅니다.
... ... ... ... name string 앨범 아티스트의 이름을 나타냅니다.

  • (호출예)
    http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.3&itemtype=album&option=album&query=best&option2=artist&query2=leejung
요청 변수 설명
... ... item - 개별 검색 결과이며, title, link을 포함합니다. 파라메터 id는 maniadb song_id를 의미합니다.
... ... ... title string 노래 제목을 나타냅니다.
... ... ... runningtime string 노래 길이를 "분:초" 형태로 나타냅니다.
... ... ... link string 노래 링크를 나타냅니다.
... ... ... description string 가사 일부가 나타납니다. 최대 100글자로 구성됩니다.
... ... ... maniadb:album - 노래 수록 앨범의 정보를 나타냅니다.
... ... ... ... title string 노래 수록 앨범의 제목을 나타냅니다.
... ... ... ... release string 노래 수록 앨범의 발매일자를 나타냅니다.
... ... ... ... link string 노래 수록 앨범의 아티스트 링크를 나타냅니다.
... ... ... ... image string 노래 수록 앨범 커버를 나타냅니다. 최대 800x800으로 구성됩니다.
... ... ... ... description string 노래 수록 앨범 소개글이 나타냅니다. 최대 100글자로 구성됩니다.
... ... ... maniadb:artist - 앨범의 대표 아티스트 정보를 나타냅니다.
... ... ... ... link string 노래의 아티스트 링크를 나타냅니다.
... ... ... ... name string 노래 아티스트의 이름을 나타냅니다.

  • (호출예)
    http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.3&itemtype=song&option=song&query=love&option2=artist&query2=beatles
요청 변수 설명
... ... item - 개별 검색 결과이며, title, link을 포함합니다. 파라메터 id는 maniadb artist_id를 의미합니다.
... ... ... title string 아티스트 대표 이름을 나타냅니다.
... ... ... reference string 아티스트 참조어를 나타냅니다. 주로 동명이인 구분에 쓰입니다.
... ... ... demographic string 아티스트 셩별 및 구분(솔로/그룹 여부)을 나타냅니다.
... ... ... period string 아티스트 활동 시기를 나타냅니다.
... ... ... link string 아티스트 링크를 나타냅니다.
... ... ... image string 아티스트 대표 사진을 나타냅니다. 최대 800x800으로 구성됩니다.
... ... ... description string 아티스트 소개글이 나타냅니다. 최대 100글자로 구성됩니다.

  • (호출예)
    http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.3&itemtype=artist&option=artist&query=white
 
1. Request
url: http://www.maniadb.com/api/album.asp?v=0.3&a=[ARTIST_ID]&key=[apikey]
example: http://www.maniadb.com/api/album.asp?v=0.3&a=129420&key=example
요청 변수 설명
key string (필수) 이용 등록을 통해 받은 key 스트링을 입력합니다.
a : 필수 interger maniadb album_id
s integer maniadb album 중 상품 일련번호. 생략시 기본 앨범 정보 출력.
2. Response (XML)
요청 변수 설명
rss - 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
... channel - 앨범 정보를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다.
... ... lastBuildDate datetime 앨범 정보를 최종 수정한 시간입니다. RFC1123 포멧으로 되어 있습니다.
... ... item - 앨범 정보를 보여주는 컨테이너로, 하나만 존재합니다. title, link을 포함합니다. 파라메터 id는 maniadb album_id를 의미합니다.
... ... ... title string 앨범 제목을 나타냅니다.
... ... ... link string 앨범 링크를 나타냅니다.
... ... ... image string 앨범 커버를 나타냅니다. 최대 800x800으로 구성됩니다.
... ... ... description string 앨범 소개글이 나타냅니다. 최대 100글자로 구성됩니다.
... ... ... maniadb:merchants - 앨범 가격 비교 대상 상점 목록입니다.
... ... ... ... shop - 상점에 대한 내부 관리 고유 이름입니다.
... ... ... maniadb:artist - 앨범의 대표 아티스트 정보를 나타냅니다.
... ... ... ... id integer 앨범의 아티스트ID를 나타냅니다.
... ... ... ... name string 앨범 아티스트의 이름을 나타냅니다.
... ... ... maniadb:tracks - 앨범의 수록곡 정보를 나타냅니다.
... ... ... ... title string 디스크별 제목을 나타냅니다.
... ... ... ... song - TBD
... ... ... maniadb:products - 앨범 발매 상품의 정보를 나타냅니다.
... ... ... ... product - TBD
* Key발급 신청은 먼저 로그인을 하신 후, MyPage에서 해주시기 바랍니다.
* 기존에 ID없이 이용하시던 분들은 2008년 5월 31일까지 신청해주셔야 이상없이 사용하실 수 있습니다.
* 상업적인 목적으로 이용하실 경우는 아래 이메일(maniadb@gmail.com)로 문의 해주시기 바랍니다.
* 비상업적인 목적으로 이용하실 경우는 아래 CCL의 조건을 만족해주시면, 제약이 없습니다.
* maniadb는 크롤링과 노가다가 혼합해 구축된 것으로, 원 저작자의 요청에 의해 예고없이 특정 컨텐츠가 삭제될 수 있습니다.
COPYRIGHT (c) 1995 ~ 2022 matia, crevasse, and xfactor's maniadb.com (contact : email)
artist: 281,459 | album: 582,008 | song: 5,463,032 | CC BY-NC-SA 2.0 KR
Page rendered in 0.1441 seconds
We donate for music : 한국대중음악상 | Paranoid Magazine | Jazzpeople Magazine | Jazzpeople Magazine | 홍대를 판교로! 커먼 키친 판교
We are sponsored by : YG Entertainment (2022~) | YWMobile (2022) | Bugs (2016~22) | Soribada (2012~16) | NCsoft (2008~12) | Smith&Mobile (2005~08) | KAIST (1995~20??)
But, many big companies still steal our efforts without permission.
About maniadb.com : Wikipedia | Interview @ Ksoundlab