Analytics API는 Enterprise 플랜의 Primary Owner에게 조직의 참여도 및 채택 데이터에 대한 프로그래밍 방식의 접근을 제공합니다. 이를 사용하여 내부 대시보드를 구축하고, 채택 추세를 추적하며, Claude 참여도 데이터를 기존 보고 도구에 연결할 수 있습니다.
Analytics API는 Enterprise 플랜에서 사용 가능합니다. Primary Owner는 API 키를 생성하여 시작할 수 있습니다.
이것이 분석 대시보드 및 Compliance API와 어떻게 다른가요?
세 가지 옵션 모두 조직의 데이터에 대한 다양한 보기를 제공합니다:
분석 대시보드(Analytics를 통해 접근)는 제품의 시각화된 사용 데이터를 표시합니다. 데이터를 다른 곳에 통합할 필요가 없을 때 일일 모니터링에 적합한 도구입니다.
Analytics API는 동일한 집계된 사용 및 참여도 메트릭을 프로그래밍 방식으로 반환합니다. 따라서 BI 도구로 끌어올 수 있고, 조직도에 매핑하거나 보고 워크플로우를 자동화할 수 있습니다. 데이터는 조직별, 일별로 집계됩니다.
Compliance API는 거버넌스 및 감사 사용 사례를 위한 것입니다. 개별 사용자 작업, 원본 활동 이벤트 및 대화 내용에 접근할 수 있습니다. 감사를 위한 원본 이벤트가 아닌 대시보드용 집계된 참여도 메트릭이 필요한 경우 Analytics API를 사용하세요.
시작하기
Analytics API에 접근하려면 Enterprise 조직에 대한 Primary Owner 접근 권한이 필요합니다.
다음 단계를 따르세요:
Analytics > API keys로 이동합니다.
Analytics API 아래의 Access 토글을 찾아 켭니다.
"+ Create key"를 클릭하여 새 API 키를 생성합니다. 이 키는 비공개로 유지하세요. 비밀번호처럼 취급하세요.
요청에서
x-api-key헤더와 함께 키를 사용합니다.
전체 인증 세부 정보, 엔드포인트 참조 및 코드 예제는 Claude Enterprise Analytics API 참조 가이드를 참조하세요.
어떤 데이터를 사용할 수 있나요?
Analytics API에는 5개의 엔드포인트가 포함되어 있습니다. 모든 데이터는 조직별, 일별로 집계되며 최대 지난 90일(2026년 1월 1일 이전 제외)에 대해 사용 가능합니다.
사용자 활동: 대화 수, 전송된 메시지, 생성된 프로젝트, 업로드된 파일, 생성된 아티팩트, 사용된 스킬, 사용된 커넥터, 커밋, 풀 요청, 코드 라인 수 등 Claude Code 메트릭을 포함한 사용자별 참여도 메트릭입니다.
활동 요약: 일일, 주간 및 월간 활성 사용자 수, 좌석 활용률 및 보류 중인 초대 수를 포함한 조직 전체 데이터입니다. 요청당 최대 31일의 날짜 범위를 지원합니다.
Chat 프로젝트 사용: Claude 프로젝트의 프로젝트별로 분류된 대화 및 사용자 수입니다.
스킬 사용: 각 스킬을 사용하는 사용자 수이며, Claude 및 Claude Code 세션별로 분류됩니다.
커넥터 사용: 조직이 사용 중인 커넥터 및 각 커넥터를 사용한 고유 사용자 수입니다.
데이터 제한
모든 엔드포인트는 단일 날짜 또는 날짜 범위에 대한 데이터를 반환합니다. 데이터는 2026년 1월 1일 이후 및 3일 이상 전의 날짜에 대해서만 사용 가능합니다.
API의 기본 속도 제한은 분당 60개 요청입니다. 이것이 조직의 요구를 충족하지 못하는 경우 Anthropic 담당자 또는 영업팀에 문의하세요.