그룹별 클릭 수 (v2)

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

각 그룹에 속한 링크들의 클릭 수를 합산하여 목록 형태로 반환합니다.

한 번의 요청에서 최대 30개 그룹까지 조회할 수 있으며, 더 많은 그룹을 조회하려면 pages 파라미터를 사용해 여러 번 호출해야 합니다.

이 API는 프리미엄 요금제 이상에서만 제공됩니다.

GET

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

{
    "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
해당 그룹에 속한 링크를 클릭한 고유 사용자 수.