> ## 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.

# Fan-out 쿼리 통계

> AI가 답변을 생성하며 실제로 던진 검색 쿼리(fan-out)를 등장 횟수 기준 상위 랭킹으로 반환합니다. fan-out은 CHATGPT·PERPLEXITY·CLAUDE 답변에서만 수집되며, 그 외 모델은 항상 빈 결과입니다.

fan-out 개념과 실측 예시는 [통계로 분석하기](/guides/analytics#fan-out-쿼리-집계) 가이드를, 모델별 지원 여부는 [지원 모델](/models)을 참고하세요.


## OpenAPI

````yaml GET /v1beta/platform/fanouts/statistics
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/fanouts/statistics:
    get:
      tags:
        - FanoutStatistics
      summary: 팬아웃(검색 쿼리) 집계 조회
      description: >-
        AI가 답변을 생성하며 실제로 던진 검색 쿼리(fan-out)를 등장 횟수 기준 상위 랭킹으로 반환합니다. fan-out은
        CHATGPT·PERPLEXITY·CLAUDE 답변에서만 수집되며, 그 외 모델은 항상 빈 결과입니다.
      operationId: listFanoutStatistics
      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, 최대 200)
          in: query
          name: limit
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/domain.ListFanoutStatisticsResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/domain.Error'
          description: '잘못된 요청: runID·promptID 둘 다 누락, limit 범위 위반(1~200), 지원하지 않는 model 값'
        '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.ListFanoutStatisticsResponse:
      properties:
        fanouts:
          description: 등장 횟수 내림차순 검색 쿼리 랭킹 (상위 limit개)
          items:
            $ref: '#/components/schemas/domain.FanoutStatisticDTO'
          type: array
          uniqueItems: false
      type: object
    domain.Error:
      properties:
        code:
          type: string
        details: {}
      type: object
    domain.FanoutStatisticDTO:
      properties:
        count:
          description: 이 쿼리가 등장한 횟수
          type: integer
        latestCreatedAt:
          description: 이 쿼리가 가장 최근 등장한 시각 (RFC3339)
          type: string
        models:
          description: '이 쿼리를 던진 모델 목록 (distinct, 예: CHATGPT)'
          items:
            type: string
          type: array
          uniqueItems: false
        query:
          description: AI가 던진 검색 쿼리 문자열
          type: string
        regions:
          description: '이 쿼리가 나온 지역 목록 (distinct, 예: KR)'
          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

````