For Agents
Run NAVER searches across blogs, news, shopping, and images, translate text with Papago, geocode Korean addresses, and retrieve NAVER Login user profiles.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the NAVER Open API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with NAVER Open API.
Search NAVER blogs, news articles, books, encyclopedia entries, images, shopping products, and local businesses
Translate text with Papago neural machine translation across NAVER-supported language pairs
Detect the language of a text snippet via the Papago detectLangs endpoint
GET STARTED
Use for: Search NAVER news for recent articles about Samsung, Translate a Korean sentence into English using Papago, Geocode a Seoul street address to coordinates, Find shopping listings on NAVER for a product name
Not supported: Does not handle NAVER advertising, NAVER Cloud Platform infrastructure, or NAVER Pay transactions — use for NAVER search, Papago translation, NAVER maps, URL shortening, and NAVER Login only.
Jentic publishes the only available OpenAPI specification for NAVER Open API, keeping it validated and agent-ready. NAVER Open API is the umbrella interface to NAVER's Korean platform services — search across blogs, news, books, encyclopedia, images, shopping, and local listings, plus Papago neural machine translation, language detection, Korean romanisation, URL shortening, geocoding, and NAVER Login (OAuth 2.0) with user profile retrieval. Authentication uses paired X-Naver-Client-Id and X-Naver-Client-Secret headers for most endpoints, with a bearer token flow for the Login profile lookup.
Romanise Korean text into Latin script for display and accessibility use cases
Geocode Korean addresses to coordinates and reverse-geocode coordinates back to addresses
Shorten URLs using the NAVER URL shortener service
Authenticate users via NAVER Login OAuth 2.0 and retrieve the resulting user profile
Patterns agents use NAVER Open API for, with concrete tasks.
★ Korean Market Search Aggregation
Product and content teams targeting Korea often need to surface what NAVER users see for a query across blogs, news, and shopping. The /v1/search/blog.json, /v1/search/news.json, and /v1/search/shop.json endpoints return ranked NAVER results that drop straight into a market-research dashboard. A handful of calls cover the dominant search verticals on the Korean web in seconds.
Call /v1/search/news.json with query='반도체' and display=10 to return the top 10 recent NAVER news results.
Papago Translation in Localisation Workflows
Localisation teams shipping Korean and other Asian-language content use Papago for high-quality NMT between Korean, English, Chinese, and Japanese. POST to /v1/papago/n2mt with the source and target language codes returns translated text that can be folded into a CMS pipeline. /v1/papago/detectLangs is the natural pre-step when the source language of user-generated content is unknown.
POST to /v1/papago/n2mt with source=ko, target=en, and the user's input text, and return the translated string.
Korean Address Geocoding for Maps
Map and logistics products serving Korea need to convert local addresses into coordinates and back. The /v1/map/geocode endpoint accepts a Korean street address and returns latitude and longitude, while /v1/map/reversegeocode resolves coordinates back to an administrative address. Combining both operations covers the round-trip needs of route planning and store-locator features.
Call /v1/map/geocode with query='서울특별시 강남구 테헤란로 152' and return the latitude and longitude pair.
NAVER Login for Korean User Onboarding
Apps targeting Korean users widely support NAVER Login as a primary social sign-in. The /oauth2.0/authorize and /oauth2.0/token endpoints implement the standard OAuth 2.0 authorisation-code flow, and /v1/nid/me returns the authenticated user's profile fields. Wiring these three calls in sequence delivers a working NAVER Login implementation in a day.
After the user returns from /oauth2.0/authorize, exchange the code at /oauth2.0/token, then call /v1/nid/me with the bearer token to fetch the user's email and nickname.
Agent-Driven NAVER Access via Jentic
Agents helping users research the Korean web or process Korean content need a single, reliable entry point to NAVER's surface area. Through Jentic the agent searches by intent (for example, translating Korean text), Jentic returns the relevant NAVER operation, and the agent executes it with the client headers stored in the Jentic vault. The agent never handles raw NAVER credentials.
Search Jentic for 'translate Korean text with Papago', load the schema for /v1/papago/n2mt, and execute it on the user's input string.
16 endpoints — jentic publishes the only available openapi specification for naver open api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/search/news.json
Search NAVER news articles
/v1/search/blog.json
Search NAVER blogs
/v1/search/shop.json
Search NAVER shopping listings
/v1/papago/n2mt
Translate text with Papago
/v1/papago/detectLangs
Detect language of input text
/v1/map/geocode
Geocode a Korean address
/v1/map/reversegeocode
Reverse-geocode coordinates
/v1/nid/me
Retrieve the authenticated NAVER Login user profile
/v1/search/news.json
Search NAVER news articles
/v1/search/blog.json
Search NAVER blogs
/v1/search/shop.json
Search NAVER shopping listings
/v1/papago/n2mt
Translate text with Papago
/v1/papago/detectLangs
Detect language of input text
Three things that make agents converge on Jentic-routed access.
Credential isolation
NAVER X-Naver-Client-Id and X-Naver-Client-Secret values are stored encrypted in the Jentic vault and injected into request headers at execution time. For NAVER Login flows the bearer access token is held by Jentic so the agent never sees the raw secret.
Intent-based discovery
Agents search Jentic by intent (e.g. 'translate Korean text with Papago' or 'search NAVER news for a keyword') and Jentic returns the matching NAVER operation with its input schema for direct execution.
Time to first call
Direct integration with NAVER Open API: 2-3 days across the search, Papago, maps, and login surfaces because of the dual header auth and OAuth dance. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using NAVER Open API through Jentic.
Why is there no official OpenAPI spec for NAVER Open API?
NAVER does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call NAVER Open API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the NAVER Open API use?
Most NAVER Open API endpoints require a paired client ID and client secret sent as the X-Naver-Client-Id and X-Naver-Client-Secret request headers. NAVER Login profile reads at /v1/nid/me use a bearer access token obtained from the OAuth 2.0 flow at /oauth2.0/authorize and /oauth2.0/token.
Can I translate text with the NAVER Open API?
Yes. POST to /v1/papago/n2mt with source and target language codes plus the input string and Papago returns the translated text. /v1/papago/detectLangs identifies the source language when it is unknown, and /v1/papago/romanization romanises Korean text.
What are the rate limits for the NAVER Open API?
NAVER applies daily call quotas per service per application — for example the search endpoints are typically limited to 25,000 calls per day per app. The OpenAPI spec does not include the exact figures; check the developer console at developers.naver.com for your application's quota.
How do I run a NAVER search through Jentic?
Run pip install jentic, search Jentic for 'search NAVER news for a keyword', load the schema for /v1/search/news.json, and execute it with the query parameter. Jentic injects the X-Naver-Client-Id and X-Naver-Client-Secret headers from the vault. Sign up at https://app.jentic.com/sign-up.
Does the NAVER Open API support geocoding outside Korea?
No. The /v1/map/geocode and /v1/map/reversegeocode endpoints are intended for Korean addresses and coordinate systems. Use a global geocoder for international coverage.
/v1/map/geocode
Geocode a Korean address
/v1/map/reversegeocode
Reverse-geocode coordinates
/v1/nid/me
Retrieve the authenticated NAVER Login user profile