날짜별 클릭 수

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

조회 대상 조건

  • linkId + domain 모두 지정 → 해당 링크의 날짜별 클릭 수 조회.
  • grpIdx 지정 → 해당 그룹에 속한 링크들의 클릭 수 합계 조회.
  • 조건 없음 → 계정 전체의 시간대별 클릭 수 조회.

이 API는 지정한 기간 동안 클릭 트래픽의 변화를 분석하는데 유용합니다.
마케팅 성과 측정, 캠페인 트렌드 파악, 사용자 유입 추이 분석 등에 활용할 수 있습니다.

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

GET

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

{
    "startYmd": "2025-04-01",
    "endYmd": "2025-04-30"
}

Request Parameters

startYmddaterequired
조회 시작일 (예: 2025-04-01)
endYmddaterequired
조회 종료일 (예: 2025-04-30) 시작일과 종료일의 최대 범위는 1개월
linkIdstring
링크ID. 특수문자 또는 유니코드가 포함된 경우, 반드시 URL 인코딩 처리 필요.
퍼스널 요금제: linkId와 domain 필수, 개별 링크 클릭 수만 조회 가능.
프리미엄 요금제 이상: 선택 입력 가능.
domainstring
링크 도메인.
grpIdxinteger
링크 그룹. 그룹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

codeinteger
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultarray
ymddate
날짜.
acesCntinteger
해당 날짜의 총 클릭 수.
pernCntinteger
해당 날짜에 링크를 클릭한 고유 사용자 수.