Search API (v0.3, last updated at 2007/10/12)
1. 요청 URL (request url)
http://www.maniadb.com/api/search.asp
2. 요청 변수 (request parameter)
요청 변수 값 설명
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까지 가능합니다.
3. 출력 결과 필드 (response field)
요청 변수 값 설명
rss - 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.
... channel - 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다.
... ... lastBuildDate datetime 검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다.
... ... total integer 검색 결과 문서의 총 개수를 의미합니다.
... ... start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다.
... ... display integer 검색된 검색 결과의 개수입니다.
... ... item - 개별 검색 결과이며, title, link을 포함합니다.
3-1. 출력 결과 필드 : ALBUM
요청 변수 값 설명
... ... 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=키값&target=music&option=album&query=best&option2=artist&query2=leejung
3-2. 출력 결과 필드 : SONG
요청 변수 값 설명
... ... 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=키값&target=music&itemtype=song&option=song&query=love&option2=artist&query2=beatles
3-3. 출력 결과 필드 : ARTIST
요청 변수 값 설명
... ... 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=키값&target=music&itemtype=artist&option=artist&query=white
Album API
1. 요청 URL (request url)
http://www.maniadb.com/api/album.asp
2. 요청 변수 (request parameter)
요청 변수 값 설명
key string (필수) 이용 등록을 통해 받은 key 스트링을 입력합니다.
a : 필수 interger maniadb album_id
s integer maniadb album 중 상품 일련번호. 생략시 기본 앨범 정보 출력.
예) http://www.maniadb.com/api/album.asp?key=키값&a=129420
3. 출력 결과 필드 (response field)
요청 변수 값 설명
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의 조건을 만족해주시면, 제약이 없습니다.
w3c standard Creative Commons License Tattertools & Textcube Plugin Coverholic by Lipio & Limiss Gaseum Networks Lupin Records
copyright ⓒ 1996 ~ 2008 maniadb.com : matia & xfactor ..... database scale :: artist : 50,696 / album : 91,933 / song : 1,115,411 (116,973) ..... page access :: elapse 0.00 secs