---
title: "NAVER API HUBの概要"
slug: "naver-api-hub-overview"
updated: 2026-09-17T09:57:20Z
published: 2026-09-17T09:57:20Z
canonical: "api.ncloud-docs.com/naver-api-hub-overview"
---

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

# NAVER API HUBの概要

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

NAVER API HUBは、NAVERの検索結果と検索データ分析機能をサポートする NAVERクラウドプラットフォームのサービスです。NAVER API HUBサービスは、検索、検索キーワードのトレンド、ショッピングインサイト機能に関する APIを RESTful形式で提供します。

## APIキー

NAVER API HUBは、権限を持つユーザーのみ呼び出すことができるように識別ツールの APIキーをアカウントごとに発行しています。APIキーは、API呼び出し時の認証情報として渡すリクエストヘッダのパラメータとして使用します。そのため、NAVER API HUBを使用するには、先に APIキーを発行する必要があります。

### アプリケーションの登録

APIキーは NAVERクラウドプラットフォームコンソールの NAVER API HUBで発行できます。アプリケーションを登録する方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールにアクセスします。
2. コンソール画面右上にある **リージョン&プラットフォーム** ボタンをクリックします。
3. 利用中のリージョンとプラットフォームを選択し、 **[適用]** ボタンをクリックします。
4. コンソール画面左上にある **Menu**をクリックします。
5. **All Services** > **Application Services** > **NAVER API HUB**メニューを順にクリックします。
6. 画面左側の **Application**メニューをクリックします。
7. **Application Management**画面が表示されたら、 **[Applicationを登録]** ボタンをクリックします。
8. APIを選択し、 **[次へ]** ボタンをクリックします。
9. Application名を入力し、 **[完了]** ボタンをクリックします。

### APIキーの発行

APIキーは NAVERクラウドプラットフォームコンソールの NAVER API HUBで発行できます。発行方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールにアクセスします。
2. コンソール画面右上にある **リージョン&プラットフォーム** ボタンをクリックします。
3. 利用中のリージョンとプラットフォームを選択し、 **[適用]** ボタンをクリックします。
4. コンソール画面左上にある **Menu**をクリックします。
5. **All Services** > **Application Services** > **NAVER API HUB**メニューを順にクリックします。
6. 画面左側の **Application**メニューをクリックします。
7. **Application Management**画面が表示されたら、**Application**を選択し、**API管理**配下の **[認証情報]** ボタンをクリックします。
8. **認証情報**のポップアップが表示されたら、**Client ID**と **Client Secret**をそれぞれコピーし、 **[確認]** ボタンをクリックします。

### Client Secretの再発行

Client Secretが第三者に漏洩した、または不正使用の疑いがある場合は、再発行する必要があります。再発行方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールで、**Menu** > **All Services** > **Application Services** > **NAVER API HUB**メニューを順にクリックします。
2. 画面左側の **Application**メニューをクリックします。
3. **Application Management**画面が表示されたら、**Application**を選択し、**API管理**配下の **[認証情報]** ボタンをクリックします。
4. **認証情報**のポップアップが表示されたら、 **[再発行]** ボタンをクリックします。
5. **Client Secret変更**のポップアップが表示されたら、 **[確認]** ボタンをクリックします。

## NAVER API HUBの共通設定

NAVER API HUB APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://naverapihub.apigw.ntruss.com
```

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `X-NCP-APIGW-API-KEY-ID` | Required | NAVERクラウドプラットフォームから発行された Client ID |
| `X-NCP-APIGW-API-KEY` | Required | Client IDとマッピングする Client Secret |
| `Content-Type` | Optional | `application/json` - リクエストボディを含む POST方式の検索トレンド、ショッピングインサイト APIでのみ使用 - GET方式の検索 APIでは使用しない |

### レスポンス

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

#### レスポンスボディ

エラーレスポンスボディは、エラーが発生したレイヤーに応じて、次の3つの形式のいずれかで返されます。

**1. API Gatewayエラー** 認証エラー、ルーティングエラーなど、ゲートウェイレイヤーで発生したエラーです。`error`オブジェクトでラップされて返されます。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `error.errorCode` | String | - | エラーコード |
| `error.message` | String | - | エラーメッセージ |
| `error.details` | String | - | エラーの詳細情報 |

**2. Search APIエラー** Search APIリクエストパラメータの検証エラーです。フラットな構造で返されます。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `errorCode` | String | Required | エラーコード |
| `errorMessage` | String | Required | エラーメッセージ |

**3. Search Trend、Shopping Insightエラー** リクエストボディ検証エラーです。フラットな構造で返されます。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `errMsg` | String | Required | エラーメッセージ |
| `errId` | String | Required | エラー識別子(発生時刻を含む) |
| `body` | String | Optional | 検証に失敗したリクエストボディ |

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

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 300 | 300 | APIなし | 無効な APIリクエスト URL |
| 400 | 400 | 無効なリクエスト | - 必須のリクエスト変数が存在しないか、無効なリクエスト変数の名前 - リクエスト変数の値を URLエンコードせずに送信 |
| 401 | 401 | 認証失敗 | - Client IDと Client Secretがないか、無効な値 - Client IDと Client Secretを HTTPヘッダに正しく設定せずに呼び出す - アプリケーションで API権限が設定されていない |
| 403 | 403 | サーバが許可していない呼び出し | - HTTPSではなく HTTPで呼び出す - 必須のリクエスト変数が存在しないか、無効なリクエスト変数の名前 - リクエスト変数の値を URLエンコードせずに送信 |
| 429 | 429 | 呼び出し上限超過 | 1日の上限を超過 |
| 500 | 500 | サーバエラー | - 必須のリクエスト変数が存在しないか、無効なリクエスト変数の名前 - リクエスト変数の値を URLエンコードせずに送信 - APIの呼び出しは正常に行ったが、APIサーバのメンテナンスやシステム障害によるエラーが発生 |

#### レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

**1. API Gatewayエラー**

```
{
    "error": {
        "errorCode": "200",
        "message": "Authentication Failed",
        "details": "Authentication information are missing."
    }
}
```

**2. Search APIエラー**

```
{
    "errorCode": "SE02",
    "errorMessage": "Invalid display value (無効な displayの値です)"
}
```

**3. Search Trend、Shopping Insightエラー**

```
{
    "errMsg": "TypeError:  -> should have required property 'category'",
    "errId": "2026-06-11T17:51:49+09:00/804742176-19029958",
    "body": "{\"startDate\":\"2026-01-01\",\"endDate\":\"2026-03-31\",\"timeUnit\":\"month\"}"
}
```

## NAVER API HUB API

NAVER API HUBサービスで提供する APIの説明は次の通りです。

### 検索

検索関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [ニュース検索結果の照会](/docs/ja/naver-api-hub-search-news) | NAVER検索のニュース記事検索結果を照会 |
| [百科事典検索結果の照会](/docs/ja/naver-api-hub-search-encyc) | NAVER検索の百科事典検索結果を照会 |
| [ブログ検索結果の照会](/docs/ja/naver-api-hub-search-blog) | NAVER検索のブログ検索結果を照会 |
| [成人向けキーワードの判定](/docs/ja/naver-api-hub-search-adult) | 入力した検索キーワードが成人向けキーワードであるかどうかを判定 |
| [誤字変換結果の照会](/docs/ja/naver-api-hub-search-errata) | 韓/英キーの誤入力時の検索キーワード変換 |
| [ウェブページ検索結果の照会](/docs/ja/naver-api-hub-search-webkr) | NAVER検索のウェブページ検索結果を照会 |
| [画像検索結果の照会](/docs/ja/naver-api-hub-search-image) | NAVER検索の画像検索結果を照会 |
| [KnowledgeiN検索結果の照会](/docs/ja/naver-api-hub-search-kin) | NAVER検索の KnowledgeiN検索結果を照会 |
| [ローカル検索結果の照会](/docs/ja/naver-api-hub-search-local) | NAVERローカルサービス企業・機関の検索結果を照会 |
| [カフェ投稿検索結果の照会](/docs/ja/naver-api-hub-search-cafearticle) | NAVER検索のカフェ記事検索結果を照会 |
| [Searchのユースケース](/docs/ja/naver-api-hub-search-examples) | Shopping Insight APIの実装例 |

### 検索キーワードのトレンド

検索キーワードトレンド関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [検索キーワードトレンドの照会](/docs/ja/naver-api-hub-search-trend) | テーマでグループ化した統合検索キーワードの検索推移を照会 |
| [検索キーワードトレンドのユースケース](/docs/ja/naver-api-hub-search-trend-examples) | Search Trend APIの実装例 |

### ショッピングインサイト

ショッピングインサイト関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [分野別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-categories) | ショッピング分野ごとに検索クリック数の推移を照会 |
| [機器別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-device) | 特定のショッピング分野における検索クリック数の推移を機器別に照会 |
| [性別別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-gender) | 特定のショッピング分野における検索クリック数の推移を性別で照会 |
| [年齢別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-age) | 特定のショッピング分野における検索クリック数の推移を年齢別に照会 |
| [キーワード別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-keywords) | 特定のショッピング分野における検索クリック数の推移をキーワード別に照会 |
| [キーワード機器別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-keyword-device) | 分野・キーワードの検索クリック数の推移を機器別に照会 |
| [キーワード性別別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-keyword-gender) | 分野・キーワードの検索クリック数の推移を性別で照会 |
| [キーワード年齢別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-keyword-age) | 分野・キーワードの検索クリック数の推移を年齢別に照会 |
| [キーワード年齢別トレンドの照会](/docs/ja/naver-api-hub-shopping-insight-keyword-age) | 分野・キーワードの検索クリック数の推移を年齢別に照会 |
| [Shopping Insightのユースケース](/docs/ja/naver-api-hub-shopping-insight-examples) | Shopping Insight APIの実装例 |

## NAVER API HUB関連リソース

NAVER API HUB APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- NAVER API HUBサービスの使用方法
  - [NAVER API HUBご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apihub-overview): NAVERクラウドプラットフォームコンソールで NAVER API HUBを使用する方法
  - [Ncloud利用環境ガイド](https://guide.ncloud-docs.com//docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/applicationService/NAVER%20API%20HUB): NAVER API HUBの料金体系、NAVER API HUBの特徴と詳細機能、活用例のサマリー
  - [サービスの最新情報](https://www.ncloud.com/intro/news?categoryCode=APP&serviceCode=all): NAVER API HUBに関する最新情報
  - [お問い合わせ](https://www.ncloud.com/support/question/service): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ