국가 상세 별 재생 수, 재생시간을 조회합니다.
패키지 별 또는 동영상 별 데이터를 선택적으로 조회할 수 있습니다.
패키지 또는 동영상의 선택이 없는 경우 계정 내 모든 동영상을 조회하며, 특정 패키지 또는 동영상을 선택 시 해당 데이터만 조회합니다.
국가 별 재생 조회 API를 통해 받은 응답에서 “국가”를 확인 후 해당 “국가”를 요청 파라미터로 설정하면 해당 국가의 데이터만 조회합니다.
Request URL
GET https://api.v4.wecandeo.com/report/statistics/video/v1/country/city?country={country}&sdate={yyyy-mm-dd}&edate={yyyy-mm-dd}
Request Parameters
Parameter Name | Type | Description |
---|---|---|
sdate (Required) | String | 조회할 시작 날짜 (yyyy-mm-dd) |
edate (Required) | String | 조회할 마지막 날짜 (yyyy-mm-dd) |
country (Required) | String | 국가명 |
packageId | Number | 패키지 아이디 |
accessKey | String | 원본 키 (Original Key) |
pageSize | Number | 조회 결과 페이지당 목록 수량 (default 30) |
sortData | String | 정렬 대상 - country (국가) (default) - videoCount (재생수) - duration (재생시간) |
sortDirection | String | 정렬 옵션 - desc : 내림차순 (default) - asc : 오름차순 |
Response Example
{
"isSuccess":true,
"message":"",
"data":{
"list":[
{
"duration":"272",
"videoCount":"30",
"country":"KR",
"city":"Eunpyeong-gu"
},
{
"duration":"44",
"videoCount":"4",
"country":"KR",
"city":"Yeonsu-gu"
}
],
"requestId":"b05778c8-56ac-4bc6-b72e-0885e9fc4cd6",
"pageSize":"30",
"nextToken":""
}
}
Response Data Value
Name | Type | Description |
---|---|---|
country | String | ISO 3166-1 - 국가코드 필요 시 요청 |
city | String | 도시명칭 |
추가 데이터 요청
pageSize를 초과하는 데이터가 존재 하는 경우 다음 Request URL을 이용하여, 추가 데이터를 요청합니다.
Request URL
GET https://api.v4.wecandeo.com/report/statistics/video/v1/country/city?requestId={request_id}&nextToken={next_token}
Request Parameters
Parameter Name | Type | Description |
---|---|---|
requestId (Required) | String | 기존 요청 정보 ID |
nextToken (Required) | String | 다음 토큰 정보 |
pageSize | Number | 조회 결과 페이지당 목록 수량 (default 30) |