그룹별 클릭 수

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

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

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

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

GET

/api/link/v1/clicks-by-group?ymd={ymd}&grpIdxList={grpIdxList}&pages={pages}

{
    "ymd": "2025-08-01",
    "grpIdxList": "151,207,209",
    "pages": 1
}

Request Parameters

ymddaterequired
조회 기준 날짜. 예: 2025-08-01
grpIdxListstring

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

  • 프리미엄 요금제: 그룹 IDX 목록을 반드시 지정해야 하며, 최대 5개까지 지정할 수 있습니다.
  • 비즈니스 요금제: 그룹 IDX 목록을 생략하면 모든 그룹의 클릭 수가 조회되며, 개수 제한 없이 지정할 수도 있습니다.
pagesintegerrequired
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

codeinteger
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultobject
extraobject
페이지 및 데이타 건수 정보.
pagesinteger
현재 페이지 번호
nextPagesinteger
다음 페이지 번호
nextYnstring
다음 페이지 존재 여부
countinteger
현재 페이지의 데이터 건수
totalCountinteger
전체 데이터 건수
listarray
그룹별 클릭 수
grpIdxinteger
링크 그룹(IDX).
grpNmstring
링크 그룹(이름).
acesCntinteger
해당 그룹에 속한 링크들의 총 클릭 수.
pernCntinteger
해당 그룹에 속한 링크를 클릭한 고유 사용자 수.