NAVER API HUB overview

Available in Classic and VPC

NAVER API HUB is a NAVER Cloud Platform service that supports NAVER’s search results and search data analysis features. The NAVER API HUB service provides APIs for search, search keyword trends, and shopping insights in the RESTful format.

API key

The NAVER API HUB issues an API key, an identification tool, to each account so that only authorized users can call it. The API key is used as a parameter in the request header that is passed as authentication information when calling the API. Therefore, to use NAVER API HUB, you must first obtain an API key.

Register application

You can obtain an API key from the NAVER API HUB in the NAVER Cloud Platform console. To register your application:

1. Access the NAVER Cloud Platform console.
2. Click Region & Platform at the upper right corner of the console page.
3. Select the Region and platform you're using, and then click [Apply].
4. Click Menu at the upper left corner of the console page.
5. Go to All Services > Application Services > NAVER API HUB.
6. Click Application from the left side of the page.
7. Click [Register application] when the Application Management page appears.
8. Select the API you want to use, and then click [Next].
9. Enter the application name, and then click [Complete].

Issue API key

You can obtain an API key from the NAVER API HUB in the NAVER Cloud Platform console. To issue them:

1. Access the NAVER Cloud Platform console.
2. Click Region & Platform at the upper right corner of the console page.
3. Select the Region and platform you're using, and then click [Apply].
4. Click Menu at the upper left corner of the console page.
5. Go to All Services > Application Services > NAVER API HUB.
6. Click Application from the left side of the page.
7. When the Application Management page appears, select Application and click [Authentication information] under Manage API.
8. When the Authentication information pop-up window appears, copy the Client ID and Client Secret respectively, and click [OK].

Reissue client secret.

If your client secret has been exposed to a third party or you suspect it has been compromised, you must reissue it. To reissue it:

1. From the NAVER Cloud Platform console, go to Menu > All Services > Application Services > NAVER API HUB.
2. Click Application from the left side of the page.
3. When the Application Management page appears, select Application and click [Authentication information] under Manage API.
4. When the Authentication information pop-up window appears, click [Reissue].
5. When the Change client secret pop-up window appears, click [OK].

Common NAVER API HUB settings

The following describes commonly used request and response formats in NAVER API HUB APIs.

Request

The following describes the common request format.

API URL

The request API URL is as follows:

https://naverapihub.apigw.ntruss.com

Request headers

The following describes the request headers.

Response

The following describes the common response format.

Response body

The error response body is returned in one of the following three formats, depending on the layer where the error occurred.

1. API Gateway errors
These are errors that occurred at the gateway layer, such as authentication failures or routing failures. They are returned wrapped in an error object.

2. Search API errors
These are validation errors in the Search API request parameters. The results are returned in a flat structure.

3. Search Trend, Shopping Insight errors
These are request body validation errors. The results are returned in a flat structure.

Response status codes

The following describes the response status codes.

Response example

For response examples when a call is successful, see each API specification. The following is a sample response upon a failed call.

1. API Gateway errors

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

2. Search API errors

{
    "errorCode": "SE02",
    "errorMessage": "Invalid display value."
}

3. Search Trend, Shopping Insight errors

{
    "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

The following describes the APIs provided by the NAVER API HUB service.

Search

The following describes the search-related APIs.

Search keyword trends

The following describes the APIs related to search keyword trends.

Shopping insight

The following describes the shopping insight-related APIs.

NAVER API HUB related resources

NAVER Cloud Platform provides a variety of related resources to help users better understand NAVER API HUB APIs.

• How to use the NAVER API HUB service
  • NAVER API HUB user guide: How to use NAVER API HUB in the NAVER Cloud Platform console
  • Ncloud user environment guide: Explore VPC and Classic environments and supported services.
  • Pricing and features: View pricing details and key capabilities.
  • Latest announcements: Stay informed about service updates and news.
  • Contact Support: Get help if you can't find what you need in the API guide.