국가 상세

국가 상세 별 재생 수, 재생시간을 조회합니다.
패키지 별 또는 동영상 별 데이터를 선택적으로 조회할 수 있습니다.
패키지 또는 동영상의 선택이 없는 경우 계정 내 모든 동영상을 조회하며, 특정 패키지 또는 동영상을 선택 시 해당 데이터만 조회합니다.

국가 별 재생 조회 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 NameTypeDescription
sdate (Required)String조회할 시작 날짜 (yyyy-mm-dd)
edate (Required)String조회할 마지막 날짜 (yyyy-mm-dd)
country (Required)String국가명
packageIdNumber패키지 아이디
accessKeyString원본 키 (Original Key)
pageSizeNumber조회 결과 페이지당 목록 수량 (default 30)
sortDataString정렬 대상
- country (국가) (default)
- videoCount (재생수)
- duration (재생시간)
sortDirectionString정렬 옵션
- 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

NameTypeDescription
countryStringISO 3166-1
- 국가코드 필요 시 요청
cityString도시명칭

추가 데이터 요청

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 NameTypeDescription
requestId (Required)String기존 요청 정보 ID
nextToken (Required)String다음 토큰 정보
pageSizeNumber조회 결과 페이지당 목록 수량 (default 30)