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의 조건을 만족해주시면, 제약이 없습니다.
|