그룹별 클릭 수 API (v2)

지정한 날짜 기준으로 링크 그룹별 클릭 수를 조회하는 API입니다.

각 그룹에 속한 링크들의 클릭 수를 합산하여 목록 형태로 반환하며, 여러 그룹을 한 번에 조회해 캠페인별 성과를 한눈에 비교할 수 있습니다.

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

GET

/api/link/v2/clicks-by-group?startYmd={startYmd}&endYmd={endYmd}&grpIdxList={grpIdxList}&pages={pages} 


GET /api/link/v2/clicks-by-group
     ?startYmd=2025-08-01
     &endYmd=2025-08-31
     &grpIdxList=151,207,209
     &pages=1

Request Parameters

startYmd date required
조회 시작일 (예: 2025-12-01)
endYmd date required
조회 종료일 (예: 2025-12-31) 시작일과 종료일의 최대 범위는 1개월.
퍼스널 요금제: 최대 7일
프리미엄 요금제: 최대 14일
grpIdxList string

조회할 그룹의 IDX 목록을 쉼표(,) 로 구분해 전달합니다. 예: 151,207,209

  • 프리미엄 요금제: 그룹 IDX 목록을 반드시 지정해야 하며, 최대 5개까지 지정할 수 있습니다.
  • 비즈니스 요금제: 그룹 IDX 목록을 생략하면 모든 그룹의 클릭 수가 조회되며, 개수 제한 없이 지정할 수도 있습니다.
pages integer required
Default:1
페이지 번호. 조회 결과의 페이지 번호입니다.
한 페이지에는 기본 30개의 결과가 반환되며, pages=2인 경우 31번째 결과부터 30개가 반환됩니다. 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 3,
            "totalCount": 3
        },
        "list": [
            {
                "grpIdx": 151,
                "grpNm": "Electronics",
                "acesCnt": 181,
                "pernCnt": 164
            },
            {
                "grpIdx": 207,
                "grpNm": "Kitchenware",
                "acesCnt": 19847,
                "pernCnt": 18095
            },
            {
                "grpIdx": 209,
                "grpNm": "Brian Smith Advertiser Only",
                "acesCnt": 5730,
                "pernCnt": 5409
            }
        ]
    }
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result object
extra object
페이지 및 데이타 건수 정보.
pages integer
현재 페이지 번호
nextPages integer
다음 페이지 번호
nextYn string
다음 페이지 존재 여부
count integer
현재 페이지의 데이터 건수
totalCount integer
전체 데이터 건수
list array
그룹별 클릭 수
grpIdx integer
링크 그룹(IDX).
grpNm string
링크 그룹(이름).
acesCnt integer
해당 그룹에 속한 링크들의 총 클릭 수.
pernCnt integer
해당 그룹에 속한 링크를 클릭한 고유 사용자 수.

언제 이 API를 사용하나요?

여러 캠페인 그룹의 성과를 날짜 기준으로 비교하고 싶을 때 사용합니다.

그룹별 총 클릭 수와 고유 사용자 수를 한 번의 요청으로 집계할 수 있어, 캠페인 간 성과 비교나 그룹별 트래픽 분석이 필요한 상황에서 특히 유용합니다.

단순 조회가 아니라 대상별 성과 비교 분석에 사용됩니다.

날짜별 클릭 수 API와 차이점

시간 → “언제 (hour)”, 날짜 → “변화 (trend)”, 그룹 → “어디서 (source)”
그룹 API는 성과 비교 분석에 최적화

여러 그룹 동시 조회 방법

grpIdxList 파라미터에 그룹 IDX를 쉼표(,)로 구분해 전달하면 여러 그룹을 한 번의 요청으로 조회할 수 있습니다.
예: 151,207,209. 한 번의 요청에 최대 30개 그룹까지 조회할 수 있으며, 더 많은 그룹을 조회하려면 pages 파라미터를 사용해 여러 번 호출해야 합니다.

요금제에 따라 grpIdxList 생략 가능 여부가 다릅니다.
프리미엄 요금제는 그룹 IDX 목록을 반드시 지정해야 하며 최대 5개까지 지정할 수 있고,
비즈니스 요금제는 생략 시 모든 그룹의 클릭 수가 조회되며 개수 제한 없이 지정할 수 있습니다.

활용 예시

  • 캠페인 성과 비교: grpIdxList에 여러 캠페인 그룹 IDX를 입력해 성과를 한 번에 비교
  • 월별 그룹 트래픽 집계: startYmd·endYmd로 월 단위 기간을 지정해 그룹별 클릭 총량 확인
  • 이벤트 반응률 비교: grpIdxList 생략(비즈니스 이상)으로 전체 그룹 클릭 수를 내려받아 상위 그룹 순위 산출
  • 대시보드 구성: 페이징을 순회하며 전체 그룹 데이터를 수집해 내부 분석 대시보드에 표시

사용 시 주의사항

  • 조회 그룹 수가 많을 경우 페이지 처리 필요합니다.
  • 데이터 양이 많을 경우 응답 시간이 증가할 수 있습니다.
  • 조회 가능한 최대 날짜 범위는 요금제에 따라 다릅니다. 퍼스널 요금제는 최대 7일, 프리미엄 요금제는 최대 14일입니다.
  • 한 페이지당 최대 30개 그룹이 반환됩니다. 전체 그룹 수가 30개를 초과하면 pages를 증가시켜 추가 요청해야 합니다.