게볼루션 모바일게임&앱 순위 API (ver 1.1)

게볼루션에서 제공하는 구글플레이 및 애플 앱스토어 순위를 웹(혹은 앱) 환경에서 구현하기 위한 가이드입니다.
게볼루션 모바일앱임&앱 순위 API (이하 순위API)를 사용하기 위해서는 게볼루션 계정으로 로그인을 하신 후 인증키를 발급받으셔야 합니다.

인증키 발급은 누구나 신청이 가능하며 발급에 특별한 제한사항이 없습니다.

- 2016-11-04 : 전체앱순위, 일반앱 순위 추가제공

1. 이용안내

1.1 이용 절차

1.2 순위API 장점

- 구글플레이와 앱스토어 순위정보를 활용함으로써 어디서든 신뢰할 수 있는 객관적인 데이터입니다.
- 여러분의 서비스에 모바일게임 순위정보를 삽입하거나 모바일게임/앱과 관련된 다양한 애플리케이션을 개발하실 수 있습니다.
- 구글플레이 및 애플 앱스토어의 최신 순위정보 확인이 가능합니다. (매일 업데이트)
- 필요에 따라 자유롭게 순위 서비스를 확장하여 나만의 컨덴츠로 제작할 수 있습니다.
- 누구나 자유롭게 무료로 연동이 가능합니다.
- 국내 혹은 전 세계에서 유일하게 연동 가능한 순위 API입니다.

1.3 순위API 연동 제한 및 유의사항

- 국내(한국)의 순위 정보만 연동이 가능합니다.
- 순위는 100위까지만 제공하며 100위 미만일 경우 존재하는 랭킹까지만 제공됩니다.
- 현재의 순위 정보만 연동이 가능합니다.(매일 오전 10:50 ~ 11:20 기준으로 업데이트 됩니다.)
- 연동된 순위정보를 본인의 서비스 DB에 주기적으로 저장하는 것을 자제해주세요. (최근 2주까지의 데이터 저장은 허용)
- 과도한 부하를 방지하기 위해 일 처리한도를 10,000건으로 제한합니다. (초과시 별도로 요청가능)

1.4 권장사항(선택사항)

- 출처를 [게볼루션]으로 명시하는 것을 권장합니다.
- 게임상세 정보 URL을 게볼루션 상세페이지로 이동하기를 권장합니다. (하단의 Response Fields -> gevolUrl)

2. 모바일게임/앱/전체 순위 조회 API

2.1 기본사항

Service API명 모바일 게임/앱/전체 순위조회
API 호출 결과 타입 XML
인증방법 인증키
스토어 구글플레이, 애플 앱스토어

2.2 Request URL

URL Method
http://api.gevolution.co.kr/rank/xml/ GET

2.3 Request Parameters

이름 Type 필수여부 기본값 설명
aCode string Y - 발급된 계정의 인증키
market string Y g g:구글플레이, a:애플 앱스토어
appType string Y game game:게임, app:일반앱, all:전체(게임+일반앱)
rankType int Y 1 1:무료, 2:유료,3:매출,4:신규무료,5:신규유료
rank int Y 10 1~OO위까지 출력 (max:100)
  • - 파라메터 이름과 값은 대.소문자를 구분하지 않습니다.
  • - rankType, rank 파라미터의 값은 숫자(정수)로 전송하셔야 합니다.
  • - 게시된 파라미터의 값이 올바르지 않거나 범위를 초과하면 명시된 기본값의 데이터가 반환됩니다.
  • - 애플 앱스토어의 경우 신규 (무료&유료) 순위 정보를 제공하지 않으며 신규순위 정보는 구글플레이만 가능합니다.

Sample URL
http://api.gevolution.co.kr/rank/xml/?aCode=HIJK372129&market=g&appType=game&rankType=1&rank=20
설명 : 구글플레이 게임 무료인기 순위 1~20위

2.4 Response Samples

응답 성공

<?xml version="1.0" encoding="utf-8" ?>
<response>
	<header>
		<resultCode>0000</resultCode>
		<resultMsg>OK</resultMsg>
	</header>
	<items>
		<item>
			<aid>3be668103bee1f603beb09403be4dd003bee1f60</aid>
			<ranking>1</ranking>
			<lastWeek>2</lastWeek>
			<gameName>보글보글 for Kakao</gameName>
			<publisher>(주)스코넥 엔터테인먼트</publisher>
			<iconUrl>http://upload.gevolution.co.kr/www/201411/41948z4886111111.png</iconUrl>
			<gevolUrl>-</gevolUrl>
			<gevolMUrl>-</gevolMUrl>
			<googleUrl>-</googleUrl>
			<appleUrl>-</appleUrl>
			<rating>-</rating>
			<movieUrl>NoData</movieUrl>
			<cafeUrl>NoData</cafeUrl>
		</item>
		<item>
			<aid>3beb09403befaa703beb09403be7f3203bee1f60</aid>
			<ranking>2</ranking>
			<lastWeek>18</lastWeek>
			<gameName>던전앤스피릿 for Kakao</gameName>
			<publisher>(주)추콩코리아</publisher>
			<iconUrl>http://upload.gevolution.co.kr/www/201411/41955z4583680556.png</iconUrl>
			<gevolUrl>-</gevolUrl>
			<googleUrl>-</googleUrl>
			<appleUrl>-</appleUrl>
			<rating>-</rating>
			<movieUrl>NoData</movieUrl>
			<cafeUrl>NoData</cafeUrl>
		</item>
		..... 중략.......
	</items>
</response>
	

응답 실패

<?xml version="1.0" encoding="utf-8" ?>
<response>
	<header>
		<resultCode>E901</resultCode>
		<resultMsg>AUTH FAILED.</resultMsg>
	</header>
</response>
	

2.5 Response Fields

응답 성공시 출력되는 필드

이름 Type 설명
aid string 해당 게임의 게볼루션 고유값
ranking integer 순위
lastWeek integer 1주전 순위
(단, 0 : 신규게임, 1000 : 100위권 밖에서 재진입)
gameName string 게임 이름
publisher string 퍼블리셔 이름
iconUrl string 앱 대표 아이콘의 이미지 URL
(단, noData : 이미지 정보 없음)
gevolUrl string 게볼루션의 앱 상세페이지 URL (PC Web)
gevolMUrl string 게볼루션의 앱상세페이지 URL (Mobile Web)
(단, noData : URL 정보 없음)
googleUrl string 구글플레이 다운로드(상세페이지) URL
(단, noData : URL 정보 없음)
appleUrl string 애플 앱스토어 다운로드(상세페이지) URL
(단, noData : URL 정보 없음)
rating integer 앱 평가 점수 (0~100)
(단, 0 : 평가점수 정보 없음)
movieUrl string 앱 홍보동영상 URL (youtube)
(단, noData : 동영상 URL 정보 없음)
cafeUrl string 공식카페 URL
(단, noData : 카페 정보 없음)

응답 실패시 에러코드(예외처리)

Code 설명
901 등록되지 않은 인증키입니다.
902 사용할 수 없는 인증키입니다.
903 서비스에 대한 호출 권한이 없습니다.
904 잘못된 형식의 호출 parameter입니다.
910 순위정보가 존재하지 않습니다.
911 잘못된 형식의 호출 parameter입니다.
912 parameter 값이 존재하지 않습니다.
920 정의되지 않은 오류가 발생하였습니다.

퍼블리셔(개발사) 게임리스트

  • 넷마블 게임순위정보 보기
  • 위메이드 게임순위정보 보기
  • 슈퍼셀 게임순위정보 보기
  • 게임로프트 게임순위정보 보기
지난순위 다시보기 게볼루션 신규게임 추천 게볼루션 소개 게볼루션 앱출시

게볼루션 AD

게임사운드 제작 - 먼데이엔터테인먼트