시간대별 클릭 수 조회 API (v2)

지정한 날짜 범위의 시간대별(00:00~23:59) 클릭 수를 조회하는 API입니다.

특정 링크·그룹 단위 또는 계정 전체의 시간대별 클릭 트래픽 분포를 분석할 수 있으며,
이벤트 성과 측정, 마케팅 집중 시간대 파악, 사용자 활동 패턴 분석 등에 활용할 수 있습니다.

이 API는 퍼스널 요금제 이상에서만 제공됩니다.

v2(레거시) 문서입니다.

신규 연동에는 최신 버전인 v3 사용을 권장합니다.
v2는 기존 연동을 유지하기 위한 버전으로, 신규 기능이나 개선 사항은 제공되지 않습니다.

GET

/api/statistics/v2/clicks-by-hour?ymd={ymd} 

{
    "ymd": "2025-04-20"
}

Request Parameters

ymd date required
조회 기준 날짜. 예: 2025-04-20
linkId string
링크ID. 특수문자 또는 유니코드가 포함된 경우, 반드시 URL 인코딩 처리 필요.
퍼스널 요금제: linkId와 domain 필수, 개별 링크 클릭 수만 조회 가능.
프리미엄 요금제 이상: 선택 입력 가능.
domain string
링크 도메인.
grpIdx integer
링크 그룹. 그룹IDX는 그룹 목록 API를 호출하거나 대시보드에서 확인할 수 있습니다.
그룹이 지정되면 해당 그룹에 속해있는 모든 링크의 클릭 수 합계가 반환되며, 프리미엄 요금제 이상에서만 사용 가능. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-20",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-20",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-20",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-20",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-20",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-20",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result array
ymd date
날짜.
hour integer
시간. (0~23)
acesCnt integer
해당 시간대의 총 클릭 수.
pernCnt integer
해당 시간대에 링크를 클릭한 고유 사용자 수.