---
title: "キーワード別トレンドの照会"
slug: "naver-api-hub-shopping-insight-keywords"
updated: 2026-10-08T07:17:02Z
published: 2026-10-08T07:17:02Z
canonical: "api.ncloud-docs.com/naver-api-hub-shopping-insight-keywords"
---

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

# キーワード別トレンドの照会

Classic/VPC環境で利用できます。

ショッピングインサイト APIは、[NAVER DataLab](https://datalab.naver.com/)の[ショッピングインサイト](https://datalab.naver.com/shoppingInsight/sCategory.naver)データを照会する RESTful APIです。NAVER統合検索のショッピングエリアおよび[NAVERショッピング](https://shopping.naver.com/ns/home)で、特定のショッピング分野における検索クリック数の推移を、検索キーワード別に確認することができます。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /shopping/v1/category/keywords |

### リクエストヘッダ

NAVER API HUBで共通して使用されるヘッダの詳細は、[NAVER API HUBのリクエストヘッダ](/docs/ja/naver-api-hub-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `startDate` | String | Required | 照会期間の開始日 (`yyyy-mm-dd`) - 2017年8月1日から照会可能 |
| `endDate` | String | Required | 照会期間の終了日 (`yyyy-mm-dd`) |
| `timeUnit` | String | Required | 区間の単位 - `date` \| `week` \| `month` - `date`: 日間 - `week`: 週間 - `month`: 月間 |
| `category` | String | Required | ショッピング分野のコード - NAVERショッピングでカテゴリを選択した際、URLの`cat_id`パラメータの値で確認 |
| `keyword` | Array | Required | 検索キーワードグループ名と検索キーワードペアの配列: [keyword](/docs/ja/naver-api-hub-shopping-insight-keywords#keyword) - 最大5つのペアまで設定可能 |
| `device` | String | Optional | 検索機器 - `pc` \| `mo` - `pc`: PC - `mo`: モバイル機器 - デフォルト: すべての機器 |
| `gender` | String | Optional | 検索ユーザーの性別による条件 - `m` \| `f` - `m`: 男性 - `f`: 女性 - デフォルト: 全性別 |
| `ages` | Array | Optional | 検索ユーザーの年齢による条件 - `10` \| `20` \| `30` \| `40` \| `50` \| `60` - `10`: 10~19才 - `20`: 20~29才 - `30`: 30~39才 - `40`: 40~49才 - `50`: 50~59才 - `60`: 60才以上 - デフォルト: 全年齢 |

#### keyword

`keyword`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `name` | String | Required | 検索キーワードグループの名前 |
| `param` | Array | Required | 比較対象の検索キーワード - 1つだけ設定可能 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request POST 'https://naverapihub.apigw.ntruss.com/shopping/v1/category/keywords' \
--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-11-01",
    "endDate": "2023-11-07",
    "timeUnit": "date",
    "category": "50000000",
    "keyword": [
        { "name": "スーツ", "param": ["スーツ"] }
    ],
    "device": "pc",
    "gender": "f",
    "ages": ["20", "30"]
}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `startDate` | String | - | 照会期間の開始日 (`yyyy-mm-dd`) |
| `endDate` | String | - | 照会期間の終了日 (`yyyy-mm-dd`) |
| `timeUnit` | String | - | 区間単位 |
| `results` | Array | - | 照会結果リスト: [results](/docs/ja/naver-api-hub-shopping-insight-keywords#results) |

#### results

`results`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `title` | String | - | 検索キーワードグループの名前 |
| `keyword` | Array | - | 検索キーワード |
| `data` | Array | - | 区間別クリック数の推移データ: [data](/docs/ja/naver-api-hub-shopping-insight-keywords#data) |

#### data

`data`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `period` | String | - | 区間別開始日 (`yyyy-mm-dd`) |
| `ratio` | Number | - | 区間ごとのクリック数の相対的な割合 - 区間ごとの結果のうち、最も大きな値を100として設定した相対値 |

### レスポンスステータスコード

NAVER API HUBで共通して使用されるレスポンスステータスコードの詳細は、[NAVER API HUBのレスポンスステータスコード](/docs/ja/naver-api-hub-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "startDate": "2023-11-01",
    "endDate": "2023-11-07",
    "timeUnit": "date",
    "results": [
        {
            "title": "スーツ",
            "keyword": [
                "スーツ"
            ],
            "data": [
                {
                    "period": "2023-11-01",
                    "ratio": 50
                },
                {
                    "period": "2023-11-02",
                    "ratio": 100
                },
                {
                    "period": "2023-11-03",
                    "ratio": 12.5
                },
                {
                    "period": "2023-11-05",
                    "ratio": 100
                }
            ]
        }
    ]
}
```