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

# 키워드 개요

> 검색 키워드 지표 API의 정의·데이터 출처와 구글·네이버 차이

여기서 **키워드**는 사용자가 구글·네이버 검색창에 실제로 입력하는 검색어입니다. 이 API는 그 검색어의 수요와 경쟁 정도(월평균 검색량·SEO 난이도·CPC·검색 의도)를 조회하고, 시드 키워드 하나에서 파생되는 연관 키워드와 자동완성 목록을 제공합니다. 지표 출처는 구글이 Google Ads, 네이버가 네이버 검색광고 데이터입니다.

AI 답변에 브랜드가 얼마나 노출됐는지는 [통계 API](/api-reference/statistics/statistics-overview)가 다루고, 키워드 API는 그 앞단입니다 — 어떤 검색어에 수요가 있고 경쟁이 어느 정도인지 알아야 어떤 콘텐츠를 만들어 AI에 인용될지 정할 수 있습니다.

## 구글 vs 네이버

| 항목                    | 구글                                         | 네이버                           |
| --------------------- | ------------------------------------------ | ----------------------------- |
| 키워드 수 (metrics·trend) | 1\~100개                                    | 1\~**15**개                    |
| 시장 파라미터               | `languageCode`(기본 ko)·`countryCode`(기본 KR) | 없음 (한국 전용)                    |
| 주요 지표                 | 검색량·SEO 난이도·CPC·검색 의도                      | PC/모바일 검색량·클릭수·클릭률·광고 경쟁      |
| 추이                    | `monthlySearches` (최대 7년)                  | `trend` (12개월 상대값 + `anchor`) |

키워드를 여러 개 받는 `metrics`·`trend`는 URL 길이 제한을 피하려고 요청 본문에 키워드를 담는 POST이고, 시드 키워드 하나만 받는 `related`·`suggestions`는 GET입니다.

지표가 비어 있는 경우도 있습니다. `metrics`가 `null`이면 데이터가 없는 키워드이고, `metrics`는 있는데 `searchVolume`이 `null`이면 의료·금융 등 Google Ads 제한 카테고리라 검색량이 비공개인 키워드입니다. 네이버는 검색량이 매우 낮으면 `pcBelowThreshold`·`mobileBelowThreshold`가 `true`로 오고 정확한 수치가 빠집니다.

실측 예시와 해석은 [키워드 데이터](/guides/keywords) 가이드를 참고하세요.