국가 상세 별 재생 수, 재생시간을 조회합니다.
패키지 별 또는 동영상 별 데이터를 선택적으로 조회할 수 있습니다.
패키지 또는 동영상의 선택이 없는 경우 계정 내 모든 동영상을 조회하며, 특정 패키지 또는 동영상을 선택 시 해당 데이터만 조회합니다.
국가 별 재생 조회 API를 통해 받은 응답에서 “국가”를 확인 후 해당 “국가”를 요청 파라미터로 설정하면 해당 국가의 데이터만 조회합니다.
Request URL
GET https://api.acs.wecandeo.com/report/stats/video/country/city?sdate={yyyy-mm-dd}&edate={yyyy-mm-dd}&country={country}&package_id={package Id}&page_size={page size}&sort_direction={sort direction}
Request Parameters
| Parameter Name | Type | Description |
|---|---|---|
| sdate(Required) | String | 조회할 시작 날짜 (yyyy-mm-dd) |
| edate(Required) | String | 조회할 마지막 날짜 (yyyy-mm-dd) |
| country(Required) | String | 국가명 |
| package_id | Number | 패키지 아이디 |
| access_key | String | 원본 키 (Original Key – Video Access Key_Level 1) |
| sort_direction | String | 정렬 옵션 - desc : 내림차순 - asc : 오름차순 |
| page_size(Required) | Number | 조회 결과 페이지당 목록 수량 |
| next_token | String | 응답 데이터가 남아있는 경우 추가하여 호출 |
| request_id | String | 응답 데이터가 남아있는 경우 추가하여 호출 |
Response Example
{
"message": "success",
"data": {
"list": [
{
"duration": 1376,
"country": "KR",
"city": "Seoul",
"video_count": 4
}, {
"duration": 686,
"country": "KR",
"city": "Gyeonggi-do",
"video_count": 4
}
],
"page_size": 2,
"next_token":"AQ3IwzaJX5eh2Ed4ZWmGT3NLCGUuONwfzC8s%2FFXzfZAMPuR1OcbuAB64hqwPNUAgm0sV7aP3tigRTFYEmyCOVf4mFSLX1YZ28Q%3D%3D",
"request_id":"6dd8ca03-bd8f-48a8-8cf3-89d73ede9664"
}
}
Response Data Value
| Name | Type | Description |
|---|---|---|
| country | String | ISO 3166-1 - 국가코드 필요 시 요청 |
| city | String | 도시명칭 |
※ 공통 Response 참조
추가 데이터 요청
- 응답 값에
next_token및request_id가 있고 추가 데이터가 필요한 경우 응답된next_token,request_id를 사용하여 추가 요청하면, 기존 데이터 이후의 데이터를 응답하게 됩니다. - 추가 데이터 요청 시
page_size를 변경하여 호출하면, 변경된page_size만큼 응답하게 됩니다.