Skip to main content
통계 API는 수집된 답변을 서버에서 집계해 상위 N개 랭킹으로 반환합니다. 인용 도메인·인용 URL·fan-out 쿼리 세 엔드포인트가 있으며, 목록 API와 동작 방식이 다르므로 아래 공통 규칙을 먼저 확인하세요. 이 페이지가 통계 API 규칙의 정본이며, 이후 추가되는 통계 엔드포인트도 이 규칙을 따릅니다.

​
스코프 규칙

복수 값을 받는 필터는 복수형 이름(runIDs·promptIDs·domains)을 씁니다. 단수 이름 파라미터(목록 API의 promptID 등)는 항상 값 하나만 받습니다.

​
랭킹·총계 규칙

  • 결과는 상위 limit개만 담는 랭킹입니다(기본 50, 최대 200). cursor 페이지네이션은 없습니다.
  • 항목의 카운트 필드는 세는 단위를 이름에 담습니다: 인용 통계는 citationCount(인용 1건 = 1), fan-out 통계는 fanoutCount(fan-out 발생 1회 = 1).
  • 조회 범위 전체의 총계를 함께 반환합니다: totalCitations(도메인·URL 통계), totalFanouts(fan-out 통계). 랭킹이 잘려도 비율(점유율)을 계산할 수 있습니다.
  • 고유 집계 단위 수는 카디널리티가 감당될 때만 제공합니다 — totalDomains는 도메인 종류가 내부 상한을 넘으면 null, 고유 URL 수는 제공하지 않습니다.

​
groupBy — 집계 축

  • 도메인·URL 통계는 groupBy로 축을 정합니다: domain(기본, eTLD+1 합산 — blog.naver.com·cafe.naver.com → naver.com) 또는 subdomain(서브도메인 구분, www.는 항상 제거).
  • domains 필터의 매칭 기준과 항목 domain 필드 표기도 같은 축을 따릅니다 — 도메인 랭킹에서 본 값을 그대로 URL 통계의 domains에 넣어 드릴다운할 수 있습니다.

​
include 옵트인

부가/무거운 필드는 기본 제외이며 include=로 요청합니다(반복 지정 가능).

​
통계에서 원본 답변으로

인용 통계에서 본 값은 답변 목록 필터에 그대로 넣을 수 있습니다: GET /answers?sourceDomain=… 또는 GET /answers?sourceURL=…. 드릴다운 경로는 도메인 랭킹 → URL 랭킹 → 그 출처를 인용한 답변 순입니다. 실측 예시와 해석, run 간 비교 방법은 통계로 분석하기 가이드를 참고하세요.