100 크레딧 무료, 카드 등록 없이

Naver Brief API

Name: Naver Brief API
Brand: SocialCrawl
Availability: InStock

검색어 하나를 뉴스와 블로그, 카페, 지식iN, 웹 문서 다섯 곳에 한꺼번에 던져 결과를 모아 돌려줍니다. 영역별 건수와 최근 블로그 글도 함께 나옵니다.

GET /v1/naver/brief

무료로 시작하기 응답 예시 보기

2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요

Naver Brief API는 언제 쓰나요

다섯 개 검색 엔드포인트를 따로 부르는 대신 국내 인터넷 여론을 한 번에 훑을 때 사용하세요.

API 레퍼런스 영문 원문

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.

69개 플랫폼을 병렬로 검색합니다

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

Naver API

Brief API로 무엇을 할 수 있을까요

Brief 엔드포인트가 통합 스키마와 계산 필드를 담은 Naver 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

# 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);

파라미터

파라미터	필수	설명
query	예	Search query (Korean or any language).
corpora	아니오	CSV subset of news,blog,cafearticle,kin,webkr (default all five). `shop` was retired by Naver on 2026-07-31 and is rejected.
display	아니오	Items per corpus (1-100, default 20).
start	아니오	1-indexed offset per corpus (1-1000, default 1). Prefer `cursor` for paging.
sort	아니오	sim (relevance, default) or date; kin also point.
include	아니오	Set to `digest` for an LLM English digest with translated quotes.
cursor	아니오	Opaque pagination token from a prior response's next_cursor.

응답 예시

Naver Brief API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기

{
  "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
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

Naver Brief API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

Naver Brief 데이터는 왜 SocialCrawl로 가져올까요

Naver 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

모든 플랫폼이 같은 스키마라 연동은 한 번이면 끝이에요
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때 참여율·예상 도달·카테고리·언어 같은 계산 필드도 함께 와요
스크래핑 인프라도, 프록시도, 속도 제한도 신경 쓰지 않아도 돼요
Naver의 현재 공개 데이터를 돌려줘요. 엔드포인트별로 문서에 적힌 캐시 구간을 쓰고 적중하면 0크레딧이에요. Cache-Control: no-cache를 보내면 정상 요금으로 새로 조회해요

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 69개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 69개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.

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"
    }
  }
}

+ 69개 플랫폼

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

네이버 브리프 API는 뭔가요?

GET /v1/naver/brief는 검색어 하나를 네이버 6개 코퍼스에 한 번에 던져요. 뉴스, 블로그, 카페 글, 지식iN, 쇼핑, 웹문서를 동시에 검색해서, 코퍼스별 원본 한국어 결과에 검색량 지도, 최근 인기 블로그, 쇼핑 가격대까지 한 번의 호출로 돌려드려요.

어떤 네이버 코퍼스를 검색하나요?

소비자 목소리가 담긴 6개 코퍼스를 병렬로 검색해요. 뉴스, 블로그, 카페 글, 지식iN, 쇼핑, 웹문서예요. corpora 값으로 검색 범위를 좁힐 수 있고, 한 곳만 보든 여섯 곳을 다 보든 요금은 10 크레딧으로 똑같아요.

네이버 브리프 요금은 얼마인가요?

한 번 호출에 10 크레딧이에요. 코퍼스를 몇 개 펼치든 요금은 같아요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받아요. 요청한 코퍼스의 절반이 안 돌아오면 일부 환불, 여섯 개가 모두 실패하면 10 크레딧 전액을 돌려드려요.

digest 옵션은 뭔가요?

include=digest를 붙이면 상위 한국어 결과를 영어 요약으로 정리해 번역 인용구와 함께 SSE로 흘려보내요. corpora 안의 원본 한국어는 그대로 둬요. 요약은 별도 필드라서 원문과 바로 읽을 수 있는 영어 브리프를 같이 받아볼 수 있어요.

한국 시장 조사에 네이버 브리프를 왜 쓰나요?

네이버는 블로그, 카페, 지식iN, 한국 쇼핑 정보처럼 한국 웹을 어떤 엔진보다 깊게 색인해요. 게다가 해외 데이터 업체는 네이버를 아예 검색하지 않아요. 브리프 한 번이면 한국 대행사가 며칠씩 모으던 소비자 여론 그림을 바로 받아볼 수 있어요.

원본 한국어 텍스트는 그대로 보존되나요?

네, corpora 안의 모든 항목은 원본 한국어를 그대로 유지해요. 일치한 검색어에 붙는 네이버 <b> 하이라이트 태그까지 살아 있어요. 원본은 절대 손대지 않고 번역은 선택값인 digest 필드에서만 일어나요. 그래서 인용할 원문을 늘 그대로 들고 있게 돼요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

Naver API의 다른 엔드포인트

Naver의 모든 엔드포인트가 같은 통합 스키마를 돌려줘요.

Blog Search News Search Encyc Search Cafearticle Search Kin Search Local Search

API 레퍼런스 Naver API 가이드

Naver Brief 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 Naver 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요