> ## 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. # 인용 URL 통계 > 조직의 답변에 인용된 출처를 URL 단위로 집계합니다. urls는 인용 수 내림차순 상위 limit개만 담는 랭킹이며(페이지네이션 아님), 스코프 내 총 인용 수(totalCitations)를 함께 반환합니다. domain을 지정하면 그 도메인 아래 인용된 URL만 보므로, 자사 페이지가 인용됐는지 상위 limit 제한에 걸리지 않고 확인할 수 있습니다. 실측 예시(실제 인용 문장 포함)와 해석은 [통계로 분석하기](/guides/analytics#인용-url-랭킹) 가이드를 참고하세요. ## OpenAPI ````yaml GET /v1beta/platform/sources/statistics/urls openapi: 3.1.0 info: description: >- 외부 파트너용 플랫폼 API. 조직 API 키 기반 인증을 사용합니다. ### 공통 요청 제한 - 요청 body 크기는 최대 2MiB이며, 초과 시 413과 함께 `COMMON_REQUEST_BODY_TOO_LARGE` 코드를 반환합니다. - 배열 파라미터와 문자열 필드에는 엔드포인트별 개수·길이 상한이 있습니다. 상한은 각 필드/파라미터 설명에 명시되어 있으며, 위반 시 400과 함께 `COMMON_VALIDATION` 코드를 반환합니다. - 검증 실패 시 `details` 배열에 위반 필드와 사유가 담깁니다. 예: `{"code":"COMMON_VALIDATION","message":"데이터 검증에 실패했습니다","details":["keywords: 최대 100개까지 입력할 수 있습니다"]}` - `message`와 `details`는 Accept-Language 헤더에 따라 한국어(ko) 또는 영어(en)로 제공됩니다. title: Platform API version: '1.0' servers: - url: https://dev-platform-api.trychainshift.ai/api security: [] tags: - description: API 키가 귀속되는 최상위 계정 단위입니다. 조직의 기본 정보를 조회합니다. name: Organization - description: AI 서비스에서 노출을 모니터링하는 대상 브랜드입니다. 브랜드 등록·조회·수정·삭제를 제공합니다. name: Brand - description: >- 브랜드와 시장을 분석하기 위한 키워드 인텔리전스입니다. 구글·네이버 검색 지표, 연관·자동완성 키워드 조회와 사이트 URL 기반 키워드 분석을 제공합니다. name: Keyword - description: 프롬프트를 목적별로 묶는 그룹입니다. 프롬프트 세트 생성·조회·수정·삭제를 제공합니다. name: PromptSet - description: AI 서비스에 질의하는 문장 단위입니다. 프롬프트 생성·조회·수정·삭제와 대량 생성을 제공합니다. name: Prompt - description: 실행(Run)에 사용하는 AI 서비스 모델입니다. 지원 모델 목록을 조회합니다. name: Model - description: Run 제출에 사용하는 실행 지역입니다. 지원 리전 목록을 조회합니다. name: Region - description: 프롬프트를 AI 서비스에 실제로 실행하는 작업 단위입니다. Run 제출과 진행 상태·목록 조회를 제공합니다. name: Run - description: 실행으로 수집된 AI 서비스의 응답입니다. 인용 출처·검색 쿼리를 포함한 답변을 조회합니다. name: Answer - description: 답변에 인용된 출처를 도메인·URL 단위로 집계한 지표입니다. 인용 요약, 도메인별·URL별 인용 집계를 조회합니다. name: SourceStatistics - description: 답변 본문의 토큰(Kiwi 명사)을 집계한 지표입니다. 많이 나온 토큰 랭킹과 특정 단어의 근접 토큰을 조회합니다. name: AnswerStatistics - description: AI가 답변 생성 시 실제로 던진 검색 쿼리(팬아웃)를 집계한 지표입니다. 검색 쿼리별 등장 횟수 랭킹을 조회합니다. name: FanoutStatistics - description: 텍스트에서 고유명사를 식별하는 부가 기능입니다. 고유명사 추출을 제공합니다. name: ProperNoun - description: 조직 크레딧 잔액 및 플랫폼 API 과금 정보입니다. 현재 크레딧 잔액을 조회합니다. name: Credit externalDocs: description: '' url: '' paths: /v1beta/platform/sources/statistics/urls: get: tags: - SourceStatistics summary: URL별 인용 집계 조회 description: >- 조직의 답변에 인용된 출처를 URL 단위로 집계합니다. urls는 인용 수 내림차순 상위 limit개만 담는 랭킹이며(페이지네이션 아님), 스코프 내 총 인용 수(totalCitations)를 함께 반환합니다. domain을 지정하면 그 도메인 아래 인용된 URL만 보므로, 자사 페이지가 인용됐는지 상위 limit 제한에 걸리지 않고 확인할 수 있습니다. operationId: listSourceStatisticsURLs parameters: - description: 특정 Run 필터 (제출 시 발급된 Run ID). runID·promptID 중 최소 하나 필수 (ID 문자열) in: query name: runID schema: type: string - description: 특정 프롬프트 필터. runID·promptID 중 최소 하나 필수 (ID 문자열) in: query name: promptID schema: type: string - description: 모델 필터. GET /models 로 조회 가능한 모델만 허용 in: query name: model schema: enum: - CHATGPT - GOOGLE_OVERVIEW - GOOGLE_AI - PERPLEXITY - GEMINI - NAVER_AI_BRIEFING - NAVER_AI_TAB - CLAUDE type: string - description: >- 도메인 필터. 여러 번 전달 가능(최대 50개, 각 253자 이내. 예: ?domain=naver.com&domain=mybrand.com). eTLD+1 기준 in: query name: domain schema: items: type: string type: array style: form - description: >- 추가로 포함할 필드 (예: ?include=quotes). 지원 값: quotes(AI가 인용한 텍스트 조각, URL당 최대 20개·중복 제거), urlVariants(이 URL로 정규화·병합된 원본 URL 목록) in: query name: include schema: items: type: string type: array style: form - description: 상위 몇 개 URL까지 반환할지 (기본 50, 최대 200) in: query name: limit schema: type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/domain.ListSourceStatisticsURLsResponse' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: >- 잘못된 요청: runID·promptID 둘 다 누락, limit 범위 위반(1~200), domain 필터 개수(50개)·길이(253자) 초과, 지원하지 않는 model 또는 include 값 '401': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: '인증 실패: API 키가 유효하지 않습니다' '402': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 크레딧 부족 (INSUFFICIENT_CREDITS) '429': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 요청 한도 초과 (PLATFORM_RATE_LIMIT_EXCEEDED, Retry-After 헤더 참조) '500': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 서버 내부 오류 security: - OrgAPIKeyAuth: [] components: schemas: domain.ListSourceStatisticsURLsResponse: properties: totalCitations: description: 스코프 내 총 인용 수 type: integer urls: description: 인용 수 내림차순 URL 랭킹 (상위 limit개) items: $ref: '#/components/schemas/domain.SourceURLStatisticDTO' type: array uniqueItems: false type: object domain.Error: properties: code: type: string details: {} type: object domain.SourceURLStatisticDTO: properties: citationCount: description: 이 URL의 총 인용 수 type: integer domain: description: 해당 URL의 도메인 (도메인 미확인 시 빈 문자열) type: string quotes: description: AI가 이 URL을 인용한 텍스트 조각 (include=quotes 일 때만, 중복 제거, URL당 최대 20개) items: type: string type: array uniqueItems: false url: description: 인용된 URL type: string urlVariants: description: >- URLVariants 이 URL로 정규화·병합된 원본 URL 목록 (include=urlVariants 일 때만, FND-901). 항상 최소 1개(자기 자신)를 포함하며, m. 모바일 접두사·표시모드 쿼리파라미터·PostView.naver 쿼리 형태 등 서로 다르게 저장된 원본이 하나로 합쳐졌을 때 어떤 URL들이 합쳐졌는지 감사(audit)하는 용도다. items: type: string type: array uniqueItems: false type: object securitySchemes: OrgAPIKeyAuth: description: '"조직 API 키를 입력하세요. 예: ''cs_live_xxxx'' 또는 ''cs_test_xxxx''"' in: header name: API-Key type: apiKey ````