# Prism Korea Gap API (https://www.socialcrawl.dev/platforms/prism/korea-gap)

> Fans the Korean Naver corpora (news/blog/cafe/kin/shop/web) against the global conversation (the universal /search/everywhere leg) and computes a directional presence gap: which surface over-indexes the topic, a per-channel Korean map, and a translated quote sample (KR→EN, soft LLM). Metered 40cr full; `include` without `social` drops the everywhere leg for the 15cr web-only variant. Korean volume is a directional per-surface presence index (item-count-bounded), not absolute counts.

TL;DR: `GET /v1/prism/korea-gap` costs 40 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 | The brand/topic to compare across the global and Korean conversations. |
| `include` | no | Members include `social` (the everywhere leg) + `digest`. Drop `social` for the 15cr web-only variant. |
| `date_from` | no | Window start (YYYY-MM-DD). |
| `date_to` | no | Window end (YYYY-MM-DD). |
| `display` | no | Naver results per corpus. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/korea-gap?query=Stanley%20cup" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Korea market research API?

GET /v1/prism/korea-gap returns the gap between the global conversation and Korea's Naver conversation for a brand or topic in one call. It surfaces what the world is talking about that Korea is not, and what Korea is talking about that the rest of the world is missing, side by side.

### How do I run a Korea gap analysis?

Pass query with the brand or topic and the composite pulls the global discussion and the Naver-side Korean discussion, then contrasts the two to expose each side's blind spots. Use date_from and date_to to bound the window and display to control how the gap is laid out in the response.

### Why compare global and Naver conversations?

Korea's discussion largely lives on Naver, which most global monitoring tools never read, so a topic can be hot worldwide and invisible domestically, or vice versa. The gap is the actionable signal for market entry, localization, and spotting demand before competitors do.

### How much does a korea-gap call cost?

Each call is a flat 40 credits and returns one synchronous JSON response. If a strict majority of the source legs fail the call is partial-refunded, and if every leg fails the full 40 credits are refunded automatically. New accounts get 100 free credits with no card required.

### What does the response contain?

You get the themes present globally but absent on Naver, the themes present on Naver but absent globally, and the overlap, each with source links back to the original discussion. The include parameter picks which supporting sections come back so you can keep the payload focused.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## 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 compare the global conversation with Korea's Naver conversation for a brand via API?
- Which API shows what Korea is talking about that the rest of the world is missing?
- Is there a Korea market research API that surfaces the gap between global and Naver discussion?