> ## 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. # 네이버 키워드 지표 > 키워드 목록(최대 15개)의 네이버 검색 지표(PC·모바일 검색량·클릭수·클릭률·경쟁 정도·평균 노출 광고 수)를 조회합니다. 한국 시장 전용이라 언어·국가 코드 파라미터가 없습니다. 데이터가 없거나 검색 수요가 거의 없는 키워드는 metrics가 null입니다. 실측 예시와 해석은 [키워드 데이터](/guides/keywords#네이버-키워드-지표) 가이드를 참고하세요. ## OpenAPI ````yaml POST /v1beta/platform/keywords/naver/metrics 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/keywords/naver/metrics: post: tags: - Keyword summary: 네이버 키워드 지표 조회 description: >- 키워드 목록(최대 15개)의 네이버 검색 지표(PC·모바일 검색량·클릭수·클릭률·경쟁 정도·평균 노출 광고 수)를 조회합니다. 한국 시장 전용이라 언어·국가 코드 파라미터가 없습니다. 데이터가 없거나 검색 수요가 거의 없는 키워드는 metrics가 null입니다. operationId: getNaverKeywordMetrics requestBody: content: application/json: schema: $ref: '#/components/schemas/domain.GetNaverKeywordMetricsRequest' description: 키워드 지표 조회 요청 required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/domain.GetNaverKeywordMetricsResponse' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: '잘못된 요청: 검증 실패(키워드 1~15개·중복 불가·각 80자 이내)' '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: 서버 내부 오류 '502': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 지표 공급자 호출 실패 (KEYWORD_METRICS_PROVIDER_UNAVAILABLE) '503': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 키워드 지표 기능 비활성 (KEYWORD_METRICS_NOT_CONFIGURED) security: - OrgAPIKeyAuth: [] components: schemas: domain.GetNaverKeywordMetricsRequest: properties: keywords: description: 조회할 키워드 목록 (1~15개, 중복 불가, 각 80자 이내) items: type: string maxItems: 15 minItems: 1 type: array uniqueItems: true required: - keywords type: object domain.GetNaverKeywordMetricsResponse: properties: items: description: 키워드별 지표 (요청 keywords 순서 유지) items: $ref: '#/components/schemas/domain.NaverKeywordMetricsItemDTO' type: array uniqueItems: false required: - items type: object domain.Error: properties: code: type: string details: {} type: object domain.NaverKeywordMetricsItemDTO: properties: keyword: description: 키워드 (요청 원문 그대로) type: string metrics: $ref: '#/components/schemas/domain.NaverKeywordMetricsDTO' required: - keyword type: object domain.NaverKeywordMetricsDTO: description: 검색 지표 (null = 데이터 없음) properties: adDepth: description: 월평균 노출 광고 개수 type: integer avgCTRMobile: description: 모바일 월평균 클릭률 (%) type: number avgCTRPC: description: PC 월평균 클릭률 (%) type: number avgClickMobile: description: 모바일 월평균 클릭수 type: number avgClickPC: description: PC 월평균 클릭수 type: number competition: description: 경쟁 정도 (낮음 | 중간 | 높음) type: string mobileBelowThreshold: description: true 면 모바일 검색량이 10 미만(정확한 값 불명) type: boolean pcBelowThreshold: description: true 면 PC 검색량이 10 미만(정확한 값 불명) type: boolean searchVolumeMobile: description: 모바일 월간 검색량 type: integer searchVolumePC: description: PC 월간 검색량 type: integer searchVolumeTotal: description: 월간 검색량 합계 (PC+모바일) type: integer type: object securitySchemes: OrgAPIKeyAuth: description: '"조직 API 키를 입력하세요. 예: ''cs_live_xxxx'' 또는 ''cs_test_xxxx''"' in: header name: API-Key type: apiKey ````