엠군의 카테고리별 동영상 목록을 조회합니다.

엠군에 공개된 공식 채널의 동영상을 카테고리별로 분류하여 조회할 수 있습니다. 카테고리는 연예/스타, 음악/댄스, 영화/방송, 코믹/유머, 스포츠, 게임, 뉴스/이슈, 교양/정보, 일상/생활, 브랜드/스타일, 성인(19)등 총 11개의 장르로 구분되어 있습니다. 이 목록 중 사용할 카테고리를 선택하여 해당 카테고리의 동영상 목록을 요청할 수 있습니다.

 

Request URL 

http://openapi.mgoon.com/channeling/category/videos?chApiKey={value}&categoryId={value}

 

Request Parameters

Parameter Name Type Description
chApiKey (필수) String 채널링 API 키
categoryId (필수) Integer 요청할 카테고리 ID
– 1: 연예/스타
– 2: 음악/댄스
– 3: 영화/방송
– 4: 코믹/유머
– 5: 스포츠
– 6: 게임
– 7: 뉴스/이슈
– 8: 교양/정보
– 9: 일상/생활
– 10: 브랜드/스타일
sort Integer 동영상 목록 정렬 기준
– 1: 실시간 인기순 (기본값)
– 2: 최신 등록순
– 3: 누적 재생수 순
order Integer 동영상 목록 정렬 순서
– 1: desc 내림차순 (기본값)
– 2: asc 올림차순
page Integer 페이지 번호 (기본값=1)
perPage Integer 한 페이지에 요청할 동영상 수 (기본값=12)

 

Response Example

{
errorInfo: {
code: “NONE”,
message: “”
},
data: {
list: [
{
upload_time: “2016-03-10 10:13:42″,
videoUrl: “http://www.mgoon.com/play/partner/test0307/6508965″,
thumbnail: “http://timgs.wecandeo.com/thumb/179/20160310/10/1344_e8a33_00001.jpg”,
title: “비트윈[BEATWIN] 날 떠나지마 ver. 2_Trailer”,
height: 720,
width: 1280,
thumbnails: [
{
url: “http://timgs.wecandeo.com/thumb/179/20160310/10/1344_e8a33_00000.jpg”,
delega: “N”,
seq: 1
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160310/10/1344_e8a33_00001.jpg”,
delega: “Y”,
seq: 2
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160310/10/1345_186b0_00000.jpg”,
delega: “N”,
seq: 3
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160310/10/1345_186b0_00001.jpg”,
delega: “N”,
seq: 4
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160310/10/1345_186b0_00002.jpg”,
delega: “N”,
seq: 5
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160310/10/1345_186b0_00003.jpg”,
delega: “N”,
seq: 6
}
],
duration: 19435,
desc: “비트윈[BEATWIN] 날 떠나지마 ver. 2_Trailer”,
id: 6508965
},
{
upload_time: “2016-03-09 15:59:52″,
videoUrl: “http://www.mgoon.com/play/partner/test0307/6507991″,
thumbnail: “http://timgs.wecandeo.com/thumb/179/20160309/16/0008_5f17d_00000.jpg”,
title: “이하이 한숨”,
height: 1080,
width: 1920,
thumbnails: [
{
url: “http://timgs.wecandeo.com/thumb/179/20160309/16/0007_7a231_00000.jpg”,
delega: “N”,
seq: 1
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160309/16/0008_5f17d_00000.jpg”,
delega: “Y”,
seq: 2
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160309/16/0008_5f17d_00001.jpg”,
delega: “N”,
seq: 3
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160309/16/0009_45ce8_00000.jpg”,
delega: “N”,
seq: 4
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160309/16/0010_ac960_00000.jpg”,
delega: “N”,
seq: 5
},
{
url: “http://timgs.wecandeo.com/thumb/179/20160309/16/0010_ac960_00001.jpg”,
delega: “N”,
seq: 6
}
],
duration: 294476,
desc: “이하이 한숨”,
id: 6507991
}
],
totalCount: 1200,
perPage: 12,
page: 1
}
}

 

Response Data Value

Name Type Description
page Integer 페이지 번호
perPage Integer 페이지당 출력할 목록 수량
totalCount Integer 조회된 동영상 목록의 전체 수량
data list 동영상 목록 & 동영상 상세 정보
– 동영상 상세 정보 내용은 API 개요 문서 참조