> ## Documentation Index
> Fetch the complete documentation index at: https://dev-docs.trychainshift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 집계 공통 규칙

> 인용 통계 3종에 공통으로 적용되는 범위·랭킹·옵트인 규칙

인용 통계는 수집된 답변을 서버에서 집계해 **상위 N개 랭킹**으로 반환합니다. 목록 API와 동작 방식이 다르므로 아래 공통 규칙을 먼저 확인하세요.

## 공통 규칙

| 규칙         | 내용                                                    |
| ---------- | ----------------------------------------------------- |
| 범위 지정 필수   | `runID` 또는 `promptID` 중 **최소 하나**. 조직 전체 집계는 불가       |
| 랭킹 방식      | 상위 `limit`개만 반환 (기본 50, 최대 200). **cursor 페이지네이션 없음** |
| `model` 필터 | 특정 모델의 답변만 집계 (선택)                                    |
| 시간 필터 없음   | 기간별 추이는 실행을 정기 제출하고 실행별 통계를 비교하는 방식으로                 |

## include 옵트인

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

| 값             | 엔드포인트     | 추가되는 것             |
| ------------- | --------- | ------------------ |
| `models`      | 인용 도메인 통계 | 도메인별 모델 분해 카운트     |
| `quotes`      | 인용 URL 통계 | AI가 실제 인용한 문장      |
| `urlVariants` | 인용 URL 통계 | 정규화로 합쳐진 원본 URL 목록 |

## 자주 묻는 질문

**결과가 비어 있습니다.**
① 실행이 아직 진행 중이거나(상태 확인), ② 지정 범위에 출처를 제공한 성공 답변이 없거나, ③ fan-out 통계를 fan-out 미지원 모델([지원 모델](/models) 참고)로만 조회한 경우입니다. 존재하지 않거나 내 조직이 아닌 ID를 지정해도 404가 아니라 **빈 결과**가 반환됩니다.

실측 예시와 해석은 [통계로 분석하기](/guides/analytics) 가이드를 참고하세요.