날짜

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

Request URL

GET https://api.acs.wecandeo.com/report/api-stats/live/date?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": 4,
                "unique_count": 3,
                "viral_count": 0,
                "date": "2024-01-08"                
            }, {
                "total_count": 5,
                "unique_count": 4,
                "viral_count": 0,
                "date": "2024-01-03"
            }
        ],
				"page_size": 2,
				"next_token":"AQ3IwzaJX5eh2Ed4ZWmGT3NLCGUuONwfzC8s%2FFXzfZAMPuR1OcbuAB64hqwPNUAgm0sV7aP3tigRTFYEmyCOVf4mFSLX1YZ28Q%3D%3D",
        "request_id":"6dd8ca03-bd8f-48a8-8cf3-89d73ede9664"
    }
}

Response Data Value

Name	Type	Description
date	String	날짜
total_count	Number	유효 재생수
viral_count	Number	바이럴 클릭수
unique_count	Number	유니크 재생수

추가 데이터 요청

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