Application

Available in Classic and VPC

Once you've reviewed the NAVER API HUB specifications, you're ready to start using the service. Your next step is subscribing to and managing NAVER API HUB. You can subscribe to and manage your NAVER API HUB in the NAVER Cloud Platform console.

Here are the topics covered in this guide:

• Subscribe to the service.
• Register an application.
• Check application information.
• Edit an application.
• Delete an application.
• Manage NAVER API HUB usage.
  • Check daily/monthly usage.
  • Set usage limits.
  • Set threshold notifications.
  • Set notification recipients.
• Unsubscribe from the service.

Subscribe to the service.

To subscribe to NAVER API HUB:

1. Access the NAVER Cloud Platform console.
2. Click Region & Platform in the upper-right corner of the console interface.
3. Select the region and platform you are using, and click [Apply].
4. Click Menu on the upper-left corner of the console interface.
5. Navigate to Services > Application Services > NAVER API HUB.
6. Click the Subscription menu.
7. Click [Subscribe].
8. When the popup appears, check the guides on the terms of service and the provision of personal information to a third party, and if you agree, select the checkbox at the bottom.
9. Click [OK].
10. Check the list of applications that you can register and proceed to the following steps:
    • Register an application.
    • Check application information.
    • Edit an application.
    • Delete an application.

Register an application

You must register the application after agreeing to the API terms of service. The application is strictly required to use the API of NAVER API HUB. Since the Client ID and Client Secret values are included in the HTTP header values and transferred when calling the API, unique Client ID and Client Secret values are created per application when you register an application.

To register an application:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.

2. Click the Application menu.

3. Click [Register an application].

4. Select an API you want to register in the Select API interface, and click [Next].

   • You can select a category and search at the top right.
   • You can check the [Pricing information] and [Development guide] in each API card.
   • The provided APIs are as follows:

     Category	API	Description	Maximum number of calls per month
     NAVER Search	News	View NAVER News search results.	775,000 calls
     	Blog	View NAVER Blog search results.
     	Region	View search results of businesses and organizations in the NAVER Region service.
     	Knowledge iN	View NAVER Knowledge iN search results.
     	Cafe	View NAVER Cafe post search results.
     	Encyclopedia	View NAVER Encyclopedia search results.
     	Image	View NAVER Image search results.
     	Adult search keyword identification	Determine if input search keywords are adult search keywords.
     	Typo conversion	View conversion results of search keywords with incorrect input of Korean/English keys.
     	Web documentation	View NAVER Web documentation search results.
     Data Lab	Shopping insights	View search click trends by shopping category and keyword (segmented by device, gender, and age).	50,000 calls
     	Search keyword trends	View integrated search trends of search keywords grouped by topic.	50,000 calls

5. Check the selected application information and enter the application name in the Application information input interface.

   • Selected application: API item selected in the previous step.
   • Application name: Enter the application name.
     • Can enter up to 20 characters.
     • Only alphanumeric characters and special characters (-) are allowed.

6. Click [Complete].

   • The application is registered.

Check application information

You can view the registered application list in the Application Services > NAVER API HUB > Application menu of the NAVER Cloud Platform console. To check application information from the application list:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.
2. Click the Application menu.
3. Check application information.
   • Application: The name of the app set when you registered the application
   • Category: Service selected when you registered the application
   • API: Service selected when you registered the application
   • Daily usage: Real-time daily usage per API (UTC+9)
   • Monthly usage: Real-time monthly usage per API (UTC+9)
   • Registration date and time: Date and time when the application was registered
   • Settings: Settings for API call usage limits and notifications when a specific threshold (%) is exceeded
4. Click [Credentials].
   
5. When the authentication information window appears, check the authentication information.
   • Application Key
     • Application name: Name used to distinguish the application.
     • Client ID (X-NCP-APIGW-API-KEY-ID): An ID required for authentication. Enter it as X-NCP-APIGW-API-KEY-ID in the header or query string. Click {height="" width=""} to copy the value.
     • Client Secret (X-NCP-APIGW-API-KEY): A SecretKey password required for authentication. Enter it as X-NCP-APIGW-API-KEY in the header or query string. Click {height="" width=""} to copy the value, and click [Reissue] to change the value.
6. Click [OK].

Edit an application

To edit the registered application information:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.
2. Click the Application menu.
3. Click the button of the application you want to edit.
4. Click [Edit an application].
5. Edit the necessary information, and then click [Save].
   • The application information is updated.

Delete an application

To delete a registered application:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.
2. Click the Application menu.
3. Click the button of the application you want to delete.
4. Click [Delete application].
5. Check the application name in the [Delete application] window, and click [OK].
   • The application is deleted.

Manage usage

You can check the usage status for each registered application and set various options for billing management.

Check daily/monthly usage

To check daily and monthly usage:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.
2. Click the Application menu.
3. From the application list, check the real-time daily and monthly usage of the application you want to check.
   • Based on UTC+9.
   • The daily usage is initialized to 0 at 00:00 AM (KST).

Set usage limits

You can set daily and monthly usage limits yourself to prevent excessive service usage fees from being charged. To set usage limits:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.

2. Click the Application menu.

3. . Click [Limits and notifications] of the application for which you want to change the usage limit in the application list.
   

4. Enter the monthly and daily limit values under the [Set limits] tab menu.
   

5. Click [Save].

Set threshold notifications

When a certain usage rate of the daily/monthly limit value set by you is exceeded, you can receive notifications through email or SMS.
To set threshold notifications:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.
2. Click the Application menu.
3. Click [Limits and notifications] of the application for which you want to change the usage limit in the application list.
4. Click the checkbox for the daily or monthly limit settings item under the [Set limits] tab menu.
5. Select the threshold value (%) at which you want to be notified.
   
   • If 70% is selected, notifications are sent at 70%, 80%, 90%, and 100%.
   • If 90% is selected, notifications are sent at 90% and 100%.
6. Click [Save].
7. See Set notification recipients to enter the address at which you want to receive the threshold notifications.

Set notification recipients

To set up notification recipients and notification methods for when a certain usage rate of the daily/monthly limit value set by you is exceeded:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > Application Services > NAVER API HUB.
2. Click the Application menu.
3. Click [Limits and notifications] of the application for which you want to change the usage limit in the application list.
4. Click the [Set notification recipients] tab menu.
5. Select a notification recipient and the notification method, and then click [Add].
   • To move to Cloud Insight (monitoring) in order to add a new recipient, click [Manage notification recipients].
6. Once you complete setting up the notification recipients, click [Save].

Unsubscribe from the service

To unsubscribe from NAVER API HUB, you must delete all created NAVER API HUB applications. To cancel your NAVER API HUB subscription after deleting the applications:

1. Access the NAVER Cloud Platform console.
2. Click Region & Platform in the upper-right corner of the console interface.
3. Select the region and platform you are using, and click [Apply].
4. Click Menu on the upper-left corner of the console interface.
5. Navigate to Services > Application Services > NAVER API HUB.
6. Click the Subscription menu.
7. Click [Subscribed], then select Unsubscribe.
8. In the unsubscription popup, check the details and click [OK].
9. Click [OK] in the unsubscription popup.
   • Your subscription is now cancelled.