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

# 키워드 개요

> 구글·네이버 키워드 API의 차이와 공통 null 규칙

구글과 네이버의 검색 데이터를 조회합니다. 두 시장의 API는 구조가 비슷하지만 제한과 데이터가 다릅니다.

## 구글 vs 네이버

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

## null 규칙

* `metrics`가 `null` — 데이터가 없는 키워드입니다.
* `metrics`는 있는데 `searchVolume`이 `null` — 의료·금융 등 Google Ads 제한 카테고리로 검색량이 비공개입니다.
* 네이버 `pcBelowThreshold`/`mobileBelowThreshold`가 `true` — 검색량이 매우 낮아 정확한 수치가 제공되지 않습니다.

## 왜 조회인데 POST인가요?

`metrics`·`trend`는 키워드를 최대 100개까지 받는 배치 조회라 URL 길이 제한을 피하기 위해 요청 본문(POST)을 사용합니다. 단건 조회(`related`·`suggestions`)는 GET입니다.

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