---
title: "Get search keyword trends"
slug: "naver-api-hub-search-trend"
updated: 2026-10-08T04:15:19Z
published: 2026-10-08T04:15:19Z
canonical: "api.ncloud-docs.com/naver-api-hub-search-trend"
---

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

# Get search keyword trends

Available in Classic and VPC

The Search Keyword Trends API is a RESTful API that retrieves data from the [Search Keyword Trends](https://datalab.naver.com/keyword/trendSearch.naver) section of [NAVER DataLab](https://datalab.naver.com/). You can view search trend data from NAVER’s integrated search for search keywords grouped by topic.

## Request

This section describes the request format. The method and URI are as follows:

| Method | URI |
| --- | --- |
| POST | /search-trend/v1/search |

### Request headers

For information about the headers common to NAVER API HUB, see [NAVER API HUB request headers](/docs/en/naver-api-hub-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94).

### Request body

You can include the following data in the body of your request:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `startDate` | String | Required | Query period start date (`yyyy-mm-dd`) - Retrievable from January 1, 2016 |
| `endDate` | String | Required | Query period end date (`yyyy-mm-dd`) |
| `timeUnit` | String | Required | Section unit - `date` \| `week` \| `month` - `date`: Daily - `week`: Weekly - `month`: Monthly |
| `keywordGroups` | Array | Required | An array of keywords and pairs of search keywords corresponding to those keywords: [keywordGroups](/docs/en/naver-api-hub-search-trend#keywordGroups) - Up to 5 pairs can be configured. |
| `device` | String | Optional | Search device - `pc` \| `mo` - `pc`: Search trends on PC - `mo`: Search trends on mobile - Default: All devices |
| `gender` | String | Optional | Gender of search users - `m` \| `f` - `m`: Male - `f`: Female - Default: All genders |
| `ages` | Array | Optional | Age of search users - `1` \| `2` \| `3` \| `4` \| `5` \| `6` \| `7` \| `8` \| `9` \| `10` \| `11` - `1`: 0-12 - `2`: 13-18 - `3`: 19-24 - `4`: 25-29 - `5`: 30-34 - `6`: 35-39 - `7`: 40-44 - `8`: 45-49 - `9`: 50-54 - `10`: 55-59 - `11`: 60 or order - Default: All ages |

#### keywordGroups

The following describes `keywordGroups`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `groupName` | String | Required | Topic keyword - Name representing a group of search keywords |
| `keywords` | Array | Required | Search keywords corresponding to the topic keyword - Up to 20 search keywords can be set. |

### Request example

The request example is as follows:

```
curl --location --request POST 'https://naverapihub.apigw.ntruss.com/search-trend/v1/search' \
--header 'X-NCP-APIGW-API-KEY-ID: {Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {Client Secret}' \
--header 'Content-Type: application/json' \
--data '{
    "startDate": "2023-01-01",
    "endDate": "2023-06-30",
    "timeUnit": "month",
    "keywordGroups": [
        { "groupName": "Korean", "keywords": ["Korean", "korean"] },
        { "groupName": "English", "keywords": ["English", "english"] }
    ],
    "device": "pc",
    "gender": "f",
    "ages": ["3", "4", "5", "6", "7", "8", "9", "10", "11"]
}'
```

## Response

This section describes the response format.

### Response body

The response body includes the following data:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `startDate` | String | - | Query period start date (`yyyy-mm-dd`) |
| `endDate` | String | - | Query period end date (`yyyy-mm-dd`) |
| `timeUnit` | String | - | Section unit |
| `results` | Array | - | Query result list: [results](/docs/en/naver-api-hub-search-trend#results) |

#### results

The following describes `results`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | String | - | Topic keyword |
| `keywords` | Array | - | Search keywords corresponding to the topic keyword |
| `data` | Array | - | Search trend data by section: [data](/docs/en/naver-api-hub-search-trend#data) |

#### data

The following describes `data`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `period` | String | - | Start date by section (`yyyy-mm-dd`) |
| `ratio` | Number | - | Relative proportion of search volume by section - Relative values, with the highest value in each section set to 100 |

### Response status codes

For information about the response status codes common to all NAVER API HUB, see [NAVER API HUB response status codes](/docs/en/naver-api-hub-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

### Response example

The response example is as follows:

```
{
    "startDate": "2023-01-01",
    "endDate": "2023-06-30",
    "timeUnit": "month",
    "results": [
        {
            "title": "Korean",
            "keywords": [
                "Korean",
                "korean"
            ],
            "data": [
                {
                    "period": "2023-01-01",
                    "ratio": 70.15342
                },
                {
                    "period": "2023-02-01",
                    "ratio": 74.21207
                },
                {
                    "period": "2023-03-01",
                    "ratio": 100
                },
                {
                    "period": "2023-04-01",
                    "ratio": 84.46829
                }
            ]
        },
        {
            "title": "English",
            "keywords": [
                "English",
                "english"
            ],
            "data": [
                {
                    "period": "2023-01-01",
                    "ratio": 26.67976
                },
                {
                    "period": "2023-02-01",
                    "ratio": 25.81815
                },
                {
                    "period": "2023-03-01",
                    "ratio": 29.68029
                },
                {
                    "period": "2023-04-01",
                    "ratio": 27.57161
                }
            ]
        }
    ]
}
```