날짜별 클릭 수 조회 API (v2)

지정한 기간 동안 날짜별(YYYY-MM-DD) 클릭 수를 조회하는 API입니다.

링크·그룹 단위 또는 계정 전체의 일별 클릭 트래픽 변화를 분석할 수 있습니다.
마케팅 성과 측정, 캠페인 트렌드 파악, 사용자 유입 추이 분석 등에 활용합니다.

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

GET

/api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd} 


GET /api/statistics/v2/clicks-by-date
     ?startYmd=2025-04-01
     &endYmd=2025-04-30

Request Parameters

startYmd date required
조회 시작일 (예: 2025-04-01)
endYmd date required
조회 종료일 (예: 2025-04-30) 시작일과 종료일의 최대 범위는 1개월.
퍼스널 요금제: 최대 7일
프리미엄 요금제: 최대 14일
linkId string
링크ID. 특수문자 또는 유니코드가 포함된 경우, 반드시 URL 인코딩 처리 필요.
퍼스널 요금제: linkId와 domain 필수, 개별 링크 클릭 수만 조회 가능.
프리미엄 요금제 이상: 선택 입력 가능.
domain string
링크 도메인.
grpIdx integer
링크 그룹. 그룹IDX는 그룹 목록 API를 호출하거나 대시보드에서 확인할 수 있습니다.
그룹이 지정되면 해당 그룹에 속해있는 모든 링크의 클릭 수 합계가 반환되며, 프리미엄 요금제 이상에서만 사용 가능. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2025-04-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2025-04-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2025-04-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        },
        {
            "ymd": "2025-04-05",
            "acesCnt": 171,
            "pernCnt": 164
        }
    ]
}

Response Parameters

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

언제 이 API를 사용하나요?

특정 기간 동안 링크 클릭이 날짜별로 어떻게 변화했는지 파악하고 싶을 때 사용합니다.

캠페인 시작·종료 전후의 트래픽 변화 확인, 요일별 클릭 패턴 분석, 특정 이벤트 전후 반응률 비교 등 날짜 기반 성과 분석이 필요한 상황에서 활용합니다.

단순 집계가 아닌, 시간 흐름 기반 트렌드 분석에 사용됩니다.

시간대별 클릭 수 API와 차이점

시간대별 클릭 수 API는 하루를 0~23시로 나눠 시간 단위로 집계하고, 날짜별 클릭 수 API는 날짜 단위로 집계합니다.

단기 캠페인의 시간대별 반응을 보고 싶다면 시간대별 API를, 며칠 또는 몇 주에 걸친 트렌드를 파악하고 싶다면 날짜별 API를 사용하세요.

조회 대상 지정 방법

조회 범위는 3가지 방식으로 지정할 수 있습니다.

linkId와 domain을 함께 전달하면 해당 링크의 날짜별 클릭 수만 조회합니다.
grpIdx를 전달하면 해당 그룹에 속한 모든 링크의 클릭 수를 합산해 조회합니다.
두 조건 모두 생략하면 계정 전체의 날짜별 클릭 수가 반환됩니다.

주요 기능 및 분석 기준

이 API는 일 단위 집계 데이터를 제공합니다.

날짜별 클릭 수 (accsCnt)

  • 해당 날짜의 총 클릭 수
  • 트래픽 증가 / 감소 확인

사용자 수 (pernCnt)

  • 해당 날짜의 순 사용자 수
  • 클릭 대비 사용자 흐름 분석 가능
이 두 지표로 성장 추이, 캠페인 효과, 반복 클릭 여부를 파악할 수 있습니다.

활용 예시

  • 캠페인 성과 측정: startYmd·endYmd로 캠페인 기간을 지정해 일별 클릭 추이 확인
  • 요일별 패턴 분석: 일주일 단위로 조회해 클릭이 집중되는 요일 파악
  • 이벤트 반응률 비교: 이벤트 전후 기간을 각각 조회해 트래픽 변화량 비교
  • 이상 트래픽 탐지: 특정 날짜에 클릭 급증 시, 비정상 접근 여부 확인

사용 시 주의사항

  • 조회 가능한 최대 날짜 범위는 요금제에 따라 다르며, 범위를 초과하면 오류가 반환됩니다.
  • 일 단위 데이터는 세부 시간 정보가 포함되지 않습니다.
  • linkId에 특수문자나 유니코드가 포함된 경우 반드시 URL 인코딩 처리가 필요합니다.
  • 퍼스널 요금제에서는 linkId와 domain은 반드시 함께 전달해야 합니다.