# Naver Book Search API (https://www.socialcrawl.dev/platforms/naver/book-search)

> Searches book.naver.com — book metadata catalog. Returns books under `data.items[]` with `title`, `link`, `image` (cover URL), `author`, `discount` (price after discount, KRW), `publisher`, `pubdate` (YYYYMMDD), `isbn`, and `description`.

TL;DR: `GET /v1/naver/book/search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Free-text search term (UTF-8). Required. |
| `display` | no | Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5). |
| `start` | no | 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1). |
| `sort` | no | Sort order. Accepted values: sim\|date\|asc\|dsc (asc/dsc = price asc/desc). Defaults to `sim` (relevance) when the corpus supports sort. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/naver/book/search?query=%EB%8D%B0%EB%AF%B8%EC%95%88" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search the Naver Book catalog via API?

Send a GET request to /v1/naver/book/search with a title, author, or keyword in the query parameter. SocialCrawl returns catalog entries from book.naver.com including title, link, image, author, price, publisher, pubdate, and ISBN.

### What fields does the Naver Book endpoint return?

Each item carries title, link, cover image URL, author, discount (the price in KRW), publisher, pubdate, ISBN, and a description. The ISBN field makes it easy to match results against your own catalog or library system.

### Can I sort Naver Book results by price?

Yes. The sort parameter accepts sim (relevance), date (publication date), asc (price low to high), and dsc (price high to low). Combine asc or dsc with display and start to page through a price-ordered list of titles.

### Can I look up a book by ISBN?

Yes. Pass the ISBN as your query and the matching catalog entry comes back with its full metadata. This is the simplest way to enrich a Korean book record with cover art, pricing, and publisher details from Naver.

### How much does the Naver Book API cost?

Each Naver Book search costs 1 credit on the standard tier. New accounts receive 100 free credits and need no credit card, so you can enrich around 100 book lookups before any charge applies. Pricing stays flat per call.

See the full Naver API: https://www.socialcrawl.dev/platforms/naver

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I look up a Korean book by ISBN with an API?
- How does the SocialCrawl Naver Book API compare to Naver's Open API?