100 free credits. No credit card required
Naver Brief API
Returns one query run across five Naver corpora at once, news, blog, cafe, KnowledgeiN, and web, plus per corpus counts and the most recent blog posts.
GET /v1/naver/briefLast updated October 2026Maintained by the SocialCrawl team
When to use the Naver Brief API
Use it for a single read on the Korean internet instead of calling the five search endpoints yourself.
From the API reference
Fans a single query across Naver News, Blog, Café (community), 지식iN (Q&A), and the Korean web index in parallel, returning each corpus's raw items with the original Korean preserved, plus a volume-by-corpus map and top recent blogs. Add include=digest for an English translated synthesis with pull-quotes. The Korea-market brief no western data vendor can produce: all five corpora are native Naver. Paginate each corpus via the opaque cursor. Flat 10cr; coverage-based partial refund when a majority of corpora fail. Note computed.shop_price_range is retained as a permanent null for response-shape stability: Naver retired its Shopping search corpus on 2026-07-31 and offers no replacement.
Searching 69 platforms in parallel
·
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchNaver API
What can you do with the Brief API?
The Brief endpoint gives you structured Naver data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/naver/brief: 10 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/naver/brief?query=%EC%82%BC%EC%84%B1%EC%A0%84%EC%9E%90&corpora=news%2Cblog%2Ckin" && cat response.json# GET /v1/naver/brief: 10 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/naver/brief"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"query": "삼성전자",
"corpora": "news,blog,kin",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/naver/brief: 10 credits per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/naver/brief");
url.searchParams.set("query", "삼성전자");
url.searchParams.set("corpora", "news,blog,kin");
const body = await socialcrawl(url);
if (body) console.log(body.data);Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Search query (Korean or any language). |
| corpora | No | CSV subset of news,blog,cafearticle,kin,webkr (default all five). `shop` was retired by Naver on 2026-07-31 and is rejected. |
| 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; 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. |
Example Response
What does the Naver Brief API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "naver",
"endpoint": "/v1/naver/brief",
"data": {
"corpora": {
"news": {
"items": [
{
"post": {
"id": "http://www.metroseoul.co.kr/article/20261002500156",
"url": "http://www.metroseoul.co.kr/article/20261002500156",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": null,
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-10-02T12:34:00.000Z"
},
"computed": {
"engagement_rate": null,
"language": "ko",
"content_category": "other",
"estimated_reach": null
}
},
{
"post": {
"id": "http://www.econonews.co.kr/news/articleView.html?idxno=445212",
"url": "http://www.econonews.co.kr/news/articleView.html?idxno=445212",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": null,
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-10-02T12:30:00.000Z"
},
"computed": {
"engagement_rate": null,
"language": "ko",
"content_category": "other",
"estimated_reach": null
}
}
],
"total": 4482173,
"next_start": 21
},
"blog": {
"items": [
{
"post": {
"id": "https://blog.naver.com/user_5292a1/223932451574",
"url": "https://blog.naver.com/user_5292a1/223932451574",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": null,
"display_name": "user_d18b8e",
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2025-07-14T00:00:00.000Z"
},
"computed": {
"engagement_rate": null,
"language": "ko",
"content_category": "other",
"estimated_reach": null
}
},
{
"post": {
"id": "https://blog.aladin.co.kr/735304105/12444152",
"url": "https://blog.aladin.co.kr/735304105/12444152",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": null,
"display_name": "https://example.com/user_e9d50c",
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2021-03-06T00:00:00.000Z"
},
"computed": {
"engagement_rate": null,
"language": "ko",
"content_category": "other",
"estimated_reach": null
}
}
],
"total": 7323305,
"next_start": 21
},
"kin": {
"items": [
{
"title": "<b>삼성전자</b> 배당",
"link": "https://kin.naver.com/user_d7bfe3/detail.naver?dirId=40102&docId=495273661&answerNo=2",
"description": "<b>삼성전자</b>는 1주만 가지고 있어도 보유 수량에 정확히 비례해서 배당금을 지급합니다. 예시 (분기 배당금 주당 약 361원 기준 가정): 3주 보유 시 → 약 1,083원 (세전) 배당금이 입금될 때 배당소득세(15.4%)를 떼고 증권 계좌로 자동... "
},
{
"title": "<b>삼성전자</b> 배당금",
"link": "https://kin.naver.com/user_d7bfe3/detail.naver?dirId=40102&docId=495330377&answerNo=4",
"description": "<b>삼성전자</b>는 이번 3분기 배당 기준일을 9월 30일로 공고했어요. 국내 주식은 매수하고 2영업일 뒤에 결제가 되기 때문에, 28일에 산 주식이 30일에 내 명의로 들어오면서 기준일 주주가 돼요. 배당 받을 권리는 기준일... "
}
],
"total": 1303069,
"next_start": 21
}
},
"computed": {
"volume_by_corpus": {
"news": 4482173,
"blog": 7323305,
"kin": 1303069
},
"top_blogs": [
{
"title": "Sample comment text (redacted).",
"url": "https://blog.naver.com/user_5292a1/224047870285",
"bloggername": "user_d18b8e",
"postdate": "20251020"
},
{
"title": "Sample comment text (redacted).",
"url": "https://blog.naver.com/user_5292a1/223932451574",
"bloggername": "user_d18b8e",
"postdate": "20250714"
}
],
"shop_price_range": null,
"digest": null
},
"legs": [
{
"endpoint": "/v1/naver/news/search",
"status": 200,
"credits_used": 1,
"latency_ms": 2025,
"error": null
},
{
"endpoint": "/v1/naver/blog/search",
"status": 200,
"credits_used": 1,
"latency_ms": 2231,
"error": null
}
],
"coverage": 1,
"partial_failure": false,
"next_cursor": "eyJuZXdzIjoyMSwiYmxvZyI6MjEsImtpbiI6MjF9"
},
"credits_used": 10,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:43:27.628Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the Naver Brief API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat 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.
Ask AI about SocialCrawl
Ready to scrape Naver Brief data?
Get your API key and start pulling Naver data in under 60 seconds.