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

Request URL

GET https://api.acs.wecandeo.com/report/api-stats/live/country?sdate={yyyy-mm-dd}&edate={yyyy-mm-dd}&channel_id={channel 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)
channel_id	Number	채널 아이디
url_key	String	멀티 도메인 분류 KEY 미 입력시 기본 값 : 전체 도메인 입력시 채널 아이디 필수
sort_direction	String	정렬 옵션 desc : 내림차순 asc : 오름차순
page_size	Number	조회 결과 페이지당 목록 수량 default 10
next_token	String	응답 데이터가 남아있는 경우 추가하여 호출
request_id	String	응답 데이터가 남아있는 경우 추가하여 호출

Response Example

{
    "message": "success",
    "data": {
        "list": [
            {
                "total_count": 10,
                "country": "KR"
            }
        ],
      	"page_size": 1,
        "next_token":"AQ3IwzaJX5eh2Ed4ZWmGT3NLCGUuONwfzC8s%2FFXzfZAMPuR1OcbuAB64hqwPNUAgm0sV7aP3tigRTFYEmyCOVf4mFSLX1YZ28Q%3D%3D",
        "request_id":"6dd8ca03-bd8f-48a8-8cf3-89d73ede9664"
    }
}

Response Data Value

Name

Type

Description

country

String

ISO 3166-1

국가코드 필요 시 요청

total_count

Number

유효 재생수

추가 데이터 요청

응답 값에 next_token 및 request_id가 있고 추가 데이터가 필요한 경우 응답된 next_token, request_id를 사용하여 추가 요청하면, 기존 데이터 이후의 데이터를 응답하게 됩니다.
추가 데이터 요청 시 page_size를 변경하여 호출하면, 변경된 page_size만큼 응답하게 됩니다.