월별 클릭 수 조회 API

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

장기 트래픽 변화와 성장 추이를 분석해 캠페인 성과와 사용자 흐름을 파악할 수 있습니다.

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

GET

/api/statistics/v1/clicks-by-month?startYm={startYm}&endYm={endYm} 


GET /api/statistics/v1/clicks-by-month
     ?startYm=2026-01
     &endYm=2026-04

Request Parameters

startYm string required
조회 시작 연월입니다. YYYY-MM 형식으로 입력합니다. 예: 2026-01
endYm string required
조회 종료 연월입니다. YYYY-MM 형식으로 입력합니다. 예: 2026-04
조회 가능한 시작 연월의 기준은 요금제에 따라 다릅니다.
퍼스널 요금제: 최근 90일 이내
프리미엄 요금제: 최근 180일 이내
비즈니스 요금제: 최근 365일 이내
linkId string
링크 ID입니다. 특수문자 또는 유니코드가 포함된 경우, 반드시 URL 인코딩 처리가 필요합니다.
퍼스널 요금제: linkId와 domain 필수, 개별 링크 클릭 수만 조회 가능.
프리미엄 요금제 이상: 선택 입력 가능.
domain string
링크 도메인입니다. 커스텀 도메인을 입력할 수도 있습니다.
grpIdx integer
링크 그룹 ID입니다. 그룹 IDX는 그룹 목록 API로 조회하거나 대시보드의 그룹 목록에서 확인할 수 있습니다.
그룹이 지정되면 해당 그룹에 속한 모든 링크의 클릭 수 합계가 반환됩니다.
프리미엄 요금제 이상에서만 사용 가능합니다. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ym": "2026-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2026-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2026-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2026-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        }
    ]
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result array
ym string
연월입니다. YYYY-MM 형식으로 반환됩니다. 예: 2026-01
acesCnt integer
해당 연월의 총 클릭 수입니다.
pernCnt integer
해당 연월에 링크를 클릭한 고유 사용자 수입니다.

언제 이 API를 사용하나요?

월 단위로 링크 트래픽 추이를 파악하고 싶을 때 사용합니다.

분기별·반기별 캠페인 성과를 정리하거나, 계절성 트래픽 패턴을 분석하거나, 연간 마케팅 리포트를 작성할 때 특히 유용합니다.

날짜별 클릭 수 API보다 긴 기간의 흐름을 파악할 수 있습니다.

날짜별 클릭 수 API와 차이점

날짜별 클릭 수 API는 일 단위로 집계하여 단기 트렌드 파악에 적합하고, 월별 클릭 수 API는 월 단위로 집계하여 장기 트렌드 파악에 적합합니다.
또한 월별 API는 요금제에 따라 최대 365일까지 조회할 수 있어 연간 성과 분석에 활용하기 좋습니다.
※ 비즈니스 플러스 및 엔터프라이즈 요금제는 계약에 따라 최대 2년까지 조회 가능

요금제별 조회 제한

이 API는 퍼스널 요금제 이상에서 사용할 수 있습니다. 조회 가능한 기간은 요금제에 따라 다릅니다.

퍼스널 요금제는 최근 90일, 프리미엄 요금제는 최근 180일, 비즈니스 요금제는 최근 365일까지 조회할 수 있습니다.
grpIdx를 이용한 그룹 단위 조회는 프리미엄 요금제 이상에서만 사용할 수 있습니다.

주요 기능 및 분석 기준

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

월별 클릭 수 (accsCnt)

  • 해당 월의 총 클릭 수
  • 트래픽 성장 / 감소 추이 확인

사용자 수 (pernCnt)

  • 해당 월의 순 사용자 수
  • 실제 유입 규모 분석
이 두 지표로 성장률 분석, 시즌성 패턴, 장기 성과 평가를 파악할 수 있습니다.

활용 예시

  • 분기 성과 리포트: startYm·endYm으로 분기 기간을 지정해 월별 클릭 추이 확인
  • 계절성 분석: 1년치 데이터를 조회해 트래픽이 집중되는 월 파악
  • 그룹 캠페인 장기 추이: grpIdx로 캠페인 그룹의 월별 클릭 흐름 집계
  • 연간 마케팅 리포트: 비즈니스 요금제로 최대 365일 데이터를 수집해 연간 보고서 작성

사용 시 주의사항

  • startYm·endYm은 필수 파라미터이며 YYYY-MM 형식으로 입력합니다.
  • 조회 가능한 최대 기간은 요금제에 따라 다릅니다. 범위를 초과하면 오류가 반환됩니다.
  • linkId에 특수문자나 유니코드가 포함된 경우 반드시 URL 인코딩 처리가 필요합니다.
  • 이 API는 퍼스널 요금제 이상에서 제공됩니다. 요금제 확인 후 사용하세요.