> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/naver>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/naver.mdx>

---

# Naver API. Korea's search, blogs and places as JSON.

Search Korea's largest portal, read blogs and local businesses with their reviews, track where a place ranks, and follow search and shopping demand over time. Every response uses the same envelope.

- Search + places
- Search trends
- 1 credit per request

Naver is where Korea searches. The search endpoints cover its blog, news, cafe (community forum), KnowledgeiN (지식iN) and image tabs, the web documents on its main results page, and Naver Map's place list, each with the fields a result shows and `data.page` for paging. `GET /v1/naver/search/brief` runs one keyword across blogs, news, cafes, KnowledgeiN and the web at once.

For local businesses, `GET /v1/naver/places/{placeId}` returns a Naver Place card with address, phone, hours, menu with prices, photos and what visitors mention; `/reviews` pages through every visitor review and `/rank` checks where the place ranks for up to five keywords. Blogs have a card with daily visitors and a full post list. The trends endpoints give Naver's relative search volume for up to five keywords and Naver Shopping's click trends by category and keyword. Lookups answer `data.lookupStatus`, so a missing blog or place is `not_found`, not an HTTP error.

## What you can get

- Blog, news, cafe, KnowledgeiN and image search with paging, and sort by relevance or date for all but images.
- The web documents Naver ranks for a keyword, and a brief across five sources in one call.
- Naver Map place search in Naver's order, 300 places deep, from any map centre.
- Naver Place cards with menu prices, hours, photos and review themes, every visitor review by cursor, and rank checks.
- Blog cards with daily visitor counts and newest posts, and every post of a blog page by page.
- Search volume trends since 2016 and Naver Shopping click trends by category and keyword, with device, gender and age filters.
- Typo correction for Korean typed on an English keyboard, and the adult-term check.

## Naver endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Blog search | GET /v1/naver/search/blogs | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/blogs/get) |
| News search | GET /v1/naver/search/news | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/news/get) |
| Cafe search | GET /v1/naver/search/cafes | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/cafes/get) |
| KnowledgeiN search | GET /v1/naver/search/kin | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/kin/get) |
| Image search | GET /v1/naver/search/images | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/images/get) |
| Web search | GET /v1/naver/search/web | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/web/get) |
| Encyclopedia search | GET /v1/naver/search/encyclopedia | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/encyclopedia/get) |
| Place search | GET /v1/naver/search/places | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/places/get) |
| Search brief | GET /v1/naver/search/brief | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/brief/get) |
| Typo check | GET /v1/naver/search/typo | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/typo/get) |
| Adult-term check | GET /v1/naver/search/adult | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/search/adult/get) |
| Place | GET /v1/naver/places/{placeId} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/places/placeid/get) |
| Place reviews | GET /v1/naver/places/{placeId}/reviews | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/places/placeid/reviews/get) |
| Place rank | GET /v1/naver/places/{placeId}/rank | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/places/placeid/rank/get) |
| Blog | GET /v1/naver/blogs/{blogId} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/blogs/blogid/get) |
| Blog posts | GET /v1/naver/blogs/{blogId}/posts | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/blogs/blogid/posts/get) |
| Search trend | GET /v1/naver/trends/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/trends/search/get) |
| Shopping category trend | GET /v1/naver/trends/shopping-category | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/trends/shopping-category/get) |
| Shopping keyword trend | GET /v1/naver/trends/shopping-keywords | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/trends/shopping-keywords/get) |
| Shopping categories | GET /v1/naver/trends/shopping-categories | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/naver/trends/shopping-categories/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try several routes.
2. **Search or look up.** Search with `GET /v1/naver/search/blogs?query=손흥민`, or look up a place by its Naver Map id with `GET /v1/naver/places/1195271893`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` on lookups. Lists report `data.page`: follow `nextPage` (or `nextCursor` for reviews) while `hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Naver route charges a flat credit amount per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Social Fetch gives every Naver route one JSON shape: plain text without highlight markup, ISO 8601 dates worked out from the relative dates Naver prints, numeric counts, and typed `lookupStatus` responses. You do not need a Naver developer application or a user session to call any route.

## FAQ

### What Naver data can I get from the API?

Search results for blogs, news, cafes, KnowledgeiN, images, web documents and Naver Map places; Naver Place cards, visitor reviews and rank checks; blog cards and post lists; search volume trends; and Naver Shopping click trends.

### Do I need a Naver developer key?

No. Send your Social Fetch API key in x-api-key; there is no Naver application to register.

### How do I find a place id?

It is the number in a Naver Map URL such as map.naver.com/p/entry/place/1195271893, or data.places[].id from GET /v1/naver/search/places. Place URLs are accepted too.

### How do lists page?

Search and post lists return data.page with page, hasMore and nextPage; send page=nextPage until hasMore is false. Place reviews return page.nextCursor instead; send it back as cursor.

### Are the trend numbers absolute search counts?

No. Naver publishes relative values, 0 to 100, where 100 is the busiest period of the busiest keyword in the answer. Compare keywords inside one request.

### Can I check where my business ranks?

Yes. GET /v1/naver/places/{placeId}/rank takes up to five keywords and a map centre and returns the place's position in Naver Map's list for each.

### How much does the Naver API cost?

Every Naver route charges a flat amount per completed request, shown on each endpoint page, and each page of a list is billed separately. A found, empty or not-found answer is a completed request; invalid requests and errors are free. New accounts start with 100 free credits.

## Related

- [Naver Blog Search API](https://www.socialfetch.dev/platforms/naver/search-blogs): Blog posts by keyword (`GET /v1/naver/search/blogs`).
- [Naver Place API](https://www.socialfetch.dev/platforms/naver/places-placeid): A business card with menu, hours and ratings (`GET /v1/naver/places/{placeId}`).
- [Naver Place Reviews API](https://www.socialfetch.dev/platforms/naver/places-placeid-reviews): Every visitor review, newest first (`GET /v1/naver/places/{placeId}/reviews`).
- [Naver Search Trend API](https://www.socialfetch.dev/platforms/naver/trends-search): Search volume over time for up to five keywords (`GET /v1/naver/trends/search`).
