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

# Keywords overview

> What the keyword metrics API covers, where its data comes from, and how Google and Naver differ

Here, a **keyword** is a search term that users actually type into the Google or Naver search box. This API retrieves the demand and competition for those terms (average monthly search volume, SEO difficulty, CPC, search intent) and provides the related keywords and autocomplete suggestions derived from a single seed keyword. Google metrics come from Google Ads data, and Naver metrics come from Naver Search Ads data.

How visible your brand is in AI answers is covered by the [statistics API](https://dev-docs.trychainshift.ai/en/api-reference/statistics/statistics-overview.md). The keyword API sits upstream of it: you need to know which search terms have demand and how competitive they are before you can decide what content to create so that AI models cite it.

## Google vs Naver

| Item | Google | Naver |
| - | - | - |
| Keyword count (metrics, trend) | 1 to 100 | 1 to **15** |
| Market parameters | `languageCode` (default ko), `countryCode` (default KR) | None (Korea only) |
| Main metrics | Search volume, SEO difficulty, CPC, search intent | PC/mobile search volume, clicks, click-through rate, ad competition |
| Trend | `monthlySearches` (up to 7 years) | `trend` (12-month relative values plus `anchor`) |

`metrics` and `trend` accept multiple keywords, so they are POST requests that carry the keywords in the request body to avoid URL length limits. `related` and `suggestions` take a single seed keyword, so they are GET requests.

Metrics can be empty. If `metrics` is `null`, there is no data for that keyword. If `metrics` is present but `searchVolume` is `null`, the keyword belongs to a restricted Google Ads category such as healthcare or finance, and its search volume is not disclosed. For Naver, when search volume is very low, `pcBelowThreshold` or `mobileBelowThreshold` comes back `true` and the exact figure is omitted.

See the [Keyword data](https://dev-docs.trychainshift.ai/en/guides/keywords.md) guide for real examples and interpretation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.