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

リクエストヘッダ

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

レスポンス

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

レスポンスボディ

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

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

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

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

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

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

レスポンス例

呼び出しが成功した場合のレスポンス例は、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の説明は次の通りです。

ショッピングインサイト

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

NAVER API HUB関連リソース

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

• NAVER API HUBサービスの使用方法
  • NAVER API HUBご利用ガイド: NAVERクラウドプラットフォームコンソールで NAVER API HUBを使用する方法
  • Ncloud利用環境ガイド: VPC、Classic環境およびサポートに関する利用ガイド
  • 料金の紹介、特徴、詳細機能: NAVER API HUBの料金体系、NAVER API HUBの特徴と詳細機能、活用例のサマリー
  • サービスの最新情報: NAVER API HUBに関する最新情報
  • お問い合わせ: APIガイドだけでは不明な点が解消されない場合、直接問い合わせ