# Naver Brief API (https://www.socialcrawl.dev/platforms/naver/brief)

> Fans a single query across Naver News, Blog, Café (community), 지식iN (Q&A), Shopping, and the Korean web index in parallel, returning each corpus's raw items with the original Korean preserved, plus a volume-by-corpus map, top recent blogs, and a shopping price range. Add `include=digest` for an English translated synthesis with pull-quotes. The Korea-market brief no western data vendor can produce — all six corpora are native Naver. Paginate each corpus via the opaque `cursor`. Flat 10cr; coverage-based partial refund when a majority of corpora fail.

TL;DR: `GET /v1/naver/brief` costs 10 credits 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 | Search query (Korean or any language). |
| `corpora` | no | CSV subset of news,blog,cafearticle,kin,shop,webkr (default all six). |
| `display` | no | Items per corpus (1–100, default 20). |
| `start` | no | 1-indexed offset per corpus (1–1000, default 1). Prefer `cursor` for paging. |
| `sort` | no | sim (relevance, default) or date; shop also asc/dsc (price); kin also point. |
| `include` | no | Set to `digest` for an LLM English digest with translated quotes. |
| `cursor` | no | Opaque pagination token from a prior response's next_cursor. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/naver/brief?query=%EC%82%BC%EC%84%B1%EC%A0%84%EC%9E%90" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Naver Brief API?

GET /v1/naver/brief takes one query and fans it across six Naver corpora at once — news, blog, cafe articles, KnowledgeiN, shopping, and the Korean web index. You get each corpus's raw Korean items plus a volume-by-corpus map, the top recent blogs, and a shopping price range, all in a single call.

### Which Naver corpora does the brief endpoint search?

Six consumer-voice corpora run in parallel: news, blog, cafearticle (community), kin (지식iN Q&A), shop (shopping), and webkr (Korean web). Scope the fan-out with the corpora parameter — the price stays flat at 10 credits whether you query one corpus or all six.

### How much does a Naver brief call cost?

Each brief is a flat 10 credits, regardless of how many corpora you fan out to. New accounts get 100 free credits with no credit card. If fewer than half the requested corpora return, you get a partial refund; if all six fail, the full 10 credits are refunded.

### What is the digest option in the Naver Brief API?

Add include=digest and the endpoint streams an English synthesis of the top Korean items with translated pull-quotes via SSE. The raw Korean items in the corpora block stay untouched — the digest is a separate field, so you get both the originals and a ready-to-read English brief.

### Why use the Naver Brief API for Korea market research?

Naver indexes the Korean web — blogs, community cafes, KnowledgeiN, and Korean shopping listings — more deeply than any other engine, and no western data vendor searches it at all. One brief call returns the consumer-voice picture that a Korea agency would otherwise bill days to assemble.

### Does the brief preserve the original Korean text?

Yes. Every item in the corpora block keeps its original Korean verbatim, including Naver's <b> highlight tags around matched terms. The endpoint never mutates the raw items — translation only happens in the optional digest field, so you always have the source text to cite.

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:

- What API does Korea market research across all of Naver in one call?
- How do I search Naver news, blogs, cafes, and shopping with one query?
- Which SocialCrawl endpoint returns a Korea-market brief with an English digest?