카카오 통계

Notification > Notification Hub > API v1.0 사용 가이드 > 카카오 통계

카카오 비즈센터에서 제공하는 통계 데이터를 조회합니다. 통계 데이터는 발신 키 기준으로 일별(DAILY) 또는 월별(MONTHLY)로 조회할 수 있습니다. DAILY: 최근 90일 이내 데이터만 조회 가능하며, 조회 범위는 최대 90일입니다. MONTHLY: 최근 3개월 이내 데이터만 조회 가능하며, 조회 범위는 최대 3개월입니다.

• 실시간 통계는 제공하지 않으며, 전날 수집한 데이터를 매일 오전 7시경 제공합니다.
• 알림톡 통계는 D+1에 최초 제공하며, D+2에 확정합니다.
• 유효 읽음 수는 같은 메시지에 대해 중복 집계하지 않습니다.
• 클릭 수는 같은 메시지에 대해 중복 집계합니다.
• 발송 성공 건수가 10건 이하이면 유효 읽음 수와 클릭 수를 제공하지 않습니다.

발송 통계

발신 프로필을 기준으로 일별 발송 수, 유효 읽음 수, 클릭 수를 조회합니다. 기간, 발송 식별자, 메시지 타입 등을 설정해 조회할 수 있습니다.

템플릿 통계

템플릿 및 그룹 태그를 기준으로 일별 발송 수, 유효 읽음 수, 클릭 수를 조회합니다. 기간, 메시지 타입 등을 설정해 조회할 수 있습니다.

• 브랜드 메시지 자유형은 그룹 태그를 사용한 경우에만 제공합니다.

알림톡 발송 통계 조회

알림톡 발송 통계를 조회합니다. 발신 프로필을 기준으로 일별 발송 수, 유효 읽음 수, 클릭 수를 조회합니다. 기간, 발송 식별자, 메시지 타입 등을 설정해 조회할 수 있습니다.

조회 기간(startDate ~ endDate)은 최대 3개월입니다.

요청

GET /kakaobizcenter/v1.0/kakao-statistics/delivery-statistics/ALIMTALK
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

요청 파라미터

요청 본문

이 API는 요청 본문을 요구하지 않습니다.

응답 본문

{
  "header" : {
    "isSuccessful" : true,
    "resultCode" : 0,
    "resultMessage" : "SUCCESS"
  },
  "totalCount" : 1,
  "alimtalkDeliveryStatistics" : [ {
    "date" : "2026-01-15",
    "messageType" : "AT",
    "receiveUserType" : "PhoneNumber",
    "totalSendRequestCount" : 1000,
    "validSendRequestCount" : 950,
    "validReadCount" : 800
  } ]
}

요청 예시

### 알림톡 발송 통계 조회

GET {{endpoint}}/kakaobizcenter/v1.0/kakao-statistics/delivery-statistics/ALIMTALK?senderKey={{senderKey}}&periodType={{periodType}}&startDate={{startDate}}&endDate={{endDate}}
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

curl -X GET "${endpoint}/kakaobizcenter/v1.0/kakao-statistics/delivery-statistics/ALIMTALK?senderKey=${senderKey}&periodType=${periodType}&startDate=${startDate}&endDate=${endDate}" \
-H "X-NC-APP-KEY: {appKey}" \
-H "X-NHN-Authorization: Bearer {accessToken}"

알림톡 템플릿 통계 조회

알림톡 템플릿 통계를 조회합니다. 템플릿 및 그룹 태그를 기준으로 일별 발송 수, 유효 읽음 수, 클릭 수를 조회합니다. 기간, 메시지 타입 등을 설정해 조회할 수 있습니다.

조회 기간(startDate ~ endDate)은 최대 3개월입니다.

요청

GET /kakaobizcenter/v1.0/kakao-statistics/template-statistics/ALIMTALK
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

요청 파라미터

요청 본문

이 API는 요청 본문을 요구하지 않습니다.

응답 본문

{
  "header" : {
    "isSuccessful" : true,
    "resultCode" : 0,
    "resultMessage" : "SUCCESS"
  },
  "totalCount" : 1,
  "alimtalkTemplateStatistics" : [ {
    "date" : "2026-01-15",
    "messageType" : "AT",
    "templateCode" : "template_001",
    "totalSendSuccessCount" : 950,
    "validReadCount" : 800,
    "totalClickCount" : 500
  } ]
}

요청 예시

### 알림톡 템플릿 통계 조회

GET {{endpoint}}/kakaobizcenter/v1.0/kakao-statistics/template-statistics/ALIMTALK?senderKey={{senderKey}}&periodType={{periodType}}&startDate={{startDate}}&endDate={{endDate}}
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

curl -X GET "${endpoint}/kakaobizcenter/v1.0/kakao-statistics/template-statistics/ALIMTALK?senderKey=${senderKey}&periodType=${periodType}&startDate=${startDate}&endDate=${endDate}" \
-H "X-NC-APP-KEY: {appKey}" \
-H "X-NHN-Authorization: Bearer {accessToken}"

브랜드 메시지 발송 통계 조회

브랜드 메시지 발송 통계를 조회합니다. 발신 프로필을 기준으로 일별 발송 수, 유효 읽음 수, 클릭 수를 조회합니다. 기간, 발송 식별자, 메시지 타입 등을 설정해 조회할 수 있습니다.

조회 기간(startDate ~ endDate)은 최대 3개월입니다.

요청

GET /kakaobizcenter/v1.0/kakao-statistics/delivery-statistics/BRANDMESSAGE
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

요청 파라미터

요청 본문

이 API는 요청 본문을 요구하지 않습니다.

응답 본문

{
  "header" : {
    "isSuccessful" : true,
    "resultCode" : 0,
    "resultMessage" : "SUCCESS"
  },
  "totalCount" : 1,
  "brandmessageDeliveryStatistics" : [ {
    "date" : "2026-01-15",
    "receiveUserType" : "PhoneNumber",
    "messageSpec" : "BASIC",
    "chatBubbleType" : "TEXT",
    "friendType" : "F",
    "targeting" : "M",
    "totalSendRequestCount" : 1000,
    "validSendRequestCount" : 950,
    "validReadCount" : 800,
    "totalClickCount" : 500
  } ]
}

요청 예시

### 브랜드 메시지 발송 통계 조회

GET {{endpoint}}/kakaobizcenter/v1.0/kakao-statistics/delivery-statistics/BRANDMESSAGE?senderKey={{senderKey}}&periodType={{periodType}}&startDate={{startDate}}&endDate={{endDate}}
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

curl -X GET "${endpoint}/kakaobizcenter/v1.0/kakao-statistics/delivery-statistics/BRANDMESSAGE?senderKey=${senderKey}&periodType=${periodType}&startDate=${startDate}&endDate=${endDate}" \
-H "X-NC-APP-KEY: {appKey}" \
-H "X-NHN-Authorization: Bearer {accessToken}"

브랜드 메시지 템플릿 통계 조회

브랜드 메시지 템플릿 통계를 조회합니다. 템플릿 및 그룹 태그를 기준으로 일별 발송 수, 유효 읽음 수, 클릭 수를 조회합니다. 기간, 메시지 타입 등을 설정해 조회할 수 있습니다.

조회 기간(startDate ~ endDate)은 최대 3개월입니다.

요청

GET /kakaobizcenter/v1.0/kakao-statistics/template-statistics/BRANDMESSAGE
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

요청 파라미터

요청 본문

이 API는 요청 본문을 요구하지 않습니다.

응답 본문

{
  "header" : {
    "isSuccessful" : true,
    "resultCode" : 0,
    "resultMessage" : "SUCCESS"
  },
  "totalCount" : 1,
  "brandmessageTemplateStatistics" : [ {
    "date" : "2026-01-15",
    "templateCode" : "template_001",
    "groupTagKey" : "group_tag_001",
    "messageSpec" : "BASIC",
    "chatBubbleType" : "TEXT",
    "friendType" : "F",
    "targeting" : "M",
    "totalSendSuccessCount" : 950,
    "validReadCount" : 800,
    "totalClickCount" : 500
  } ]
}

요청 예시

### 브랜드 메시지 템플릿 통계 조회

GET {{endpoint}}/kakaobizcenter/v1.0/kakao-statistics/template-statistics/BRANDMESSAGE?senderKey={{senderKey}}&periodType={{periodType}}&startDate={{startDate}}&endDate={{endDate}}
X-NC-APP-KEY: {appKey}
X-NHN-Authorization: Bearer {accessToken}

curl -X GET "${endpoint}/kakaobizcenter/v1.0/kakao-statistics/template-statistics/BRANDMESSAGE?senderKey=${senderKey}&periodType=${periodType}&startDate=${startDate}&endDate=${endDate}" \
-H "X-NC-APP-KEY: {appKey}" \
-H "X-NHN-Authorization: Bearer {accessToken}"