Naver API

공개 네이버 검색 데이터 API

Name: Naver Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 공개 네이버 검색 표면을 구조화 JSON으로 가져옵니다. 블로그, 뉴스, 카페, 지식iN, 웹, 이미지, 지역, 트렌드, 쇼핑 인사이트를 제공합니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/naver

활성 엔드포인트는 14개입니다.

GET /v1/naver/blog/search
GET /v1/naver/news/search
GET /v1/naver/cafearticle/search
GET /v1/naver/kin/search
GET /v1/naver/webkr/search
GET /v1/naver/image/search
GET /v1/naver/local/search
GET /v1/naver/brief
GET /v1/naver/search-trend
GET /v1/naver/shopping-insight/keyword

Naver 엔드포인트

공개 네이버 검색·인사이트 읽기 엔드포인트는 14개입니다. 블로그, 뉴스, 카페, 지식iN, 웹, 이미지, 지역, brief 컴포지트, 트렌드, 쇼핑 인사이트를 제공합니다. 데이터 API만 지원합니다.

블로그 검색

1 크레딧

/v1/naver/blog/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, start, sort

뉴스 검색

1 크레딧

/v1/naver/news/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, start, sort

카페 검색

1 크레딧

/v1/naver/cafearticle/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, start, sort

지식iN 검색

1 크레딧

/v1/naver/kin/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, start, sort

웹 검색

1 크레딧

/v1/naver/webkr/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, start, sort

이미지 검색

1 크레딧

/v1/naver/image/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, start, sort, filter

지역 검색

1 크레딧

/v1/naver/local/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, display, sort

Brief 컴포지트

10 크레딧

/v1/naver/brief

공개 Brief 컴포지트 데이터를 반환합니다. 필드는 레지스트리 스키마를 따릅니다.

query, corpora, display, start, sort

검색 트렌드

5 크레딧

/v1/naver/search-trend

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

keywords, start_date, end_date, time_unit, group_name

쇼핑 인사이트 키워드

5 크레딧

/v1/naver/shopping-insight/keyword

공개 쇼핑 인사이트 키워드 데이터를 반환합니다. 필드는 레지스트리 스키마를 따릅니다.

category_code, keyword, start_date, end_date, time_unit, device

Naver API14개 엔드포인트 지원

문서 보기

검색어와 맞는 네이버 블로그 글을 돌려줍니다. 제목과 링크, 본문 일부, 블로거 이름과 블로그 링크, 작성일이 담깁니다.

국내 제품 후기와 사용법 정리가 대부분 모여 있는 긴 블로그 글을 훑을 때 사용하세요.

GET/v1/naver/blog/search?query=%EC%86%8C%EC%85%9C%ED%81%AC%EB%A1%A4&display=10

query

query · Free-text search term (UTF-8). Required.

$ curl https://www.socialcrawl.dev/v1/naver/blog/search?query=%EC%86%8C%EC%85%9C%ED%81%AC%EB%A1%A4&display=10 \
    -H "x-api-key: sc_YOUR_API_KEY"

— · 대기 중

// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Naver API 동작 방식

Naver도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/naver/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.

01쿼리

GET /v1/naver/blog/search

필요한 네이버 표면용 키워드입니다.

작업에 맞게 블로그, 뉴스, 카페, 지식iN, 웹을 고릅니다.

02검색 페이지

GET /v1/naver/news/search

제목, 스니펫, URL이 있는 순위 결과입니다.

라우트가 지원하면 start/display로 페이지를 넘깁니다.

03Brief

GET /v1/naver/cafearticle/search

여러 소스가 필요할 때 brief 다중 코퍼스 요약입니다.

코퍼스마다 수동 팬아웃 대신 한 번의 호출입니다.

04인사이트

GET /v1/naver/kin/search

수요가 질문일 때 트렌드 또는 쇼핑 인사이트 시계열입니다.

문서 검색 엔드포인트와 분리되어 있습니다.

요청

GET /v1/naver/blog/search
  ?query=소셜크롤
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

응답 봉투

{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authorblog/search

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postnews/search

items[].post에 id, url, content, engagement, author, published_at, ext

CommentListcafearticle/search

댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at

Search / Mediakin/search

검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

검증 후 차감

레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

캐시 또는 수집

platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

정규화 후 반환

upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

표준 라이브 미스: 티어 비용(보통 1 크레딧)
고급 읽기: 보통 5 크레딧
프리미엄 읽기: 보통 10 크레딧
종량제 라우트: 문서화된 최소 바닥
캐시 히트: 0 크레딧
빈 응답·하드 실패: 자동 환불
잘못된 파라미터: 400, 미과금
크레딧 부족: 402, 미과금
비활성 라우트: 503, 미과금

데이터 수집 방식

Naver은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.

이 API에서의 Naver

레지스트리에 노출된 공개 Naver 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.

SocialCrawl 접근 방식

하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.

필드 매핑

upstream identity→ author.* / data root프로필 식별자와 카운터

public item payload→ data.*게시물 본문과 참여 지표

list / search page→ items[] or hits댓글 또는 검색 결과

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

14active Naver endpoints in the registry

1 / 5 / 10표준·고급·프리미엄 크레딧 단계

한국 네이티브 검색·브랜드 모니터링

호출은 Naver 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 글로벌 소셜과 같은 키로 네이버 블로그·뉴스·카페·지식iN 검색을 제공합니다. 여러 코퍼스가 필요하면 brief 컴포지트를 사용합니다.

상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.

Naver API 활용 사례

Naver 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

트렌드 감지한국 검색어 트렌드와 카테고리별 쇼핑 클릭 추이를 조회합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

모니터링 잡

Python, cron, Slack 봇

Naver 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.

리서치·VoC

Node, 노트북, BI 적재

Naver에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.

curl "https://www.socialcrawl.dev/v1/naver/blog/search?query=소셜크롤" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/naver/news/search?query=삼성전자" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl의 Naver

카탈로그 전 구간과 같은 키

플랫폼 문서 API 키 받기

엔드포인트

Naver API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

Blog SearchSearch Naver Blog News SearchSearch Naver News Encyc SearchSearch Naver Encyclopedia Cafearticle SearchSearch Naver Cafe articles Kin SearchSearch Naver KnowledgeiN (지식iN)Local SearchSearch Naver Local (장소 검색)Image SearchSearch Naver Image Webkr SearchSearch Naver Web (웹문서)ErrataCorrect a mistyped Korean search query (오타변환)AdultCheck whether a Korean search term is adult-only (성인 검색어 판별)Search TrendGet Naver search-volume trend for Korean keywords (검색어트렌드)Shopping Insight CategoryGet Naver Shopping click trend for a category (쇼핑인사이트)Shopping Insight KeywordGet Naver Shopping click trend for keywords inside a category (쇼핑인사이트)BriefOne query across the Korean internet (5 Naver corpora) + optional digest.

비교

SocialCrawl과 네이버 오픈 API, 뭐가 다른가요?

같은 Naver 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

항목	SocialCrawl	네이버 오픈 API
인증	틱톡·인스타그램·유튜브에 쓰던 x-api-key 그대로 호출해요	앱마다 발급되는 클라이언트 ID·시크릿 쌍을 헤더에 넣어야 해요
시작 준비	가입 즉시 GET 요청 한 번이면 돼요	첫 호출 전에 네이버 개발자 센터에 앱부터 등록해야 해요
호출 한도	쓰는 만큼 크레딧으로 사면 돼서 일일 상한에 묶이지 않아요	검색 API 기준 앱당 하루 25,000회 쿼터가 있어요
응답 스키마	50개 플랫폼이 공유하는 data.items 통합 스키마로 와요	코퍼스마다 다른 네이버 전용 XML·JSON 형식이에요
요금	모든 코퍼스가 호출당 1 크레딧, 가입 시 100 크레딧 무료예요	쿼터 안에서는 무료라 소규모 프로젝트엔 충분히 매력적이에요
데이터 범위	검색 코퍼스 8종을 일관된 엔드포인트 패턴 하나로 받아요	같은 8종이지만 코퍼스마다 파라미터와 응답 특성이 달라요
유지보수	연동 한 번으로 네이버와 다른 49개 플랫폼까지 커버해요	앱별로 키와 쿼터를 따로 관리해야 해요

인증

SocialCrawl

틱톡·인스타그램·유튜브에 쓰던 x-api-key 그대로 호출해요

네이버 오픈 API

앱마다 발급되는 클라이언트 ID·시크릿 쌍을 헤더에 넣어야 해요

시작 준비

SocialCrawl

가입 즉시 GET 요청 한 번이면 돼요

네이버 오픈 API

첫 호출 전에 네이버 개발자 센터에 앱부터 등록해야 해요

호출 한도

SocialCrawl

쓰는 만큼 크레딧으로 사면 돼서 일일 상한에 묶이지 않아요

네이버 오픈 API

검색 API 기준 앱당 하루 25,000회 쿼터가 있어요

응답 스키마

SocialCrawl

50개 플랫폼이 공유하는 data.items 통합 스키마로 와요

네이버 오픈 API

코퍼스마다 다른 네이버 전용 XML·JSON 형식이에요

요금

SocialCrawl

모든 코퍼스가 호출당 1 크레딧, 가입 시 100 크레딧 무료예요

네이버 오픈 API

쿼터 안에서는 무료라 소규모 프로젝트엔 충분히 매력적이에요

데이터 범위

SocialCrawl

검색 코퍼스 8종을 일관된 엔드포인트 패턴 하나로 받아요

네이버 오픈 API

같은 8종이지만 코퍼스마다 파라미터와 응답 특성이 달라요

유지보수

SocialCrawl

연동 한 번으로 네이버와 다른 49개 플랫폼까지 커버해요

네이버 오픈 API

앱별로 키와 쿼터를 따로 관리해야 해요

자주 묻는 질문

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

문의하기

SocialCrawl 네이버 API는 무엇인가요?

네이버 공식 Open API를 감싼 통합 API예요. 블로그, 뉴스, 백과사전, 카페, 지식iN, 장소, 이미지, 웹문서까지 네이버 코퍼스 8종을 x-api-key 하나로 검색할 수 있어요. 네이버는 한국 1위 검색 포털이라, 한국어 데이터를 모으기에 가장 빠른 길이에요.

어떤 네이버 코퍼스를 검색할 수 있나요?

코퍼스 8종을 각각 /v1/naver/{corpus}/search 엔드포인트로 검색해요. 블로그, 뉴스, 백과사전, 카페 글, 지식iN, 장소 검색, 이미지, 웹문서까지요. 어떤 코퍼스든 응답이 data.items 아래 같은 통합 스키마로 와서 다루기 쉽고 간편해요. 쇼핑, 책, 전문자료 코퍼스는 네이버가 2026년 7월 31일에 종료했고 대체 API를 내놓지 않았어요. 그래서 어느 업체를 통해서도 더는 쓸 수 없어요.

네이버 개발자 앱이나 클라이언트 ID가 필요한가요?

필요 없어요. 네이버 개발자 콘솔에 따로 앱을 등록할 필요도, 클라이언트 ID·시크릿을 관리할 필요도, 앱별 일일 쿼터를 신경 쓸 필요도 없어요. 틱톡·인스타그램·유튜브에 이미 쓰던 SocialCrawl x-api-key 하나로 그대로 호출하면 돼요.

네이버 API 요금은 얼마인가요?

14개 엔드포인트 모두 호출당 1 크레딧(스탠다드 티어)이에요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받을 수 있어서, 코퍼스마다 여러 번 테스트해 보고 나서 결제하셔도 돼요. 검색 결과 개수와 상관없이 요금은 똑같아요.

한국어 콘텐츠 커버리지는 충분한가요?

네, 네이버는 블로그, 카페, 지식iN 답변처럼 구글이 잘 닿지 않는 한국 웹까지 어떤 엔진보다 깊게 색인해요. 제목과 설명은 일치한 검색어에 <b> 태그가 붙어서 와요. 그대로 하이라이트 처리해서 쓰기 쉽고 간편해요.

네이버 Open API를 직접 부르는 것과 뭐가 다른가요?

SocialCrawl은 직접 호출이 강제하는 세 가지 번거로움을 덜어내요. 앱 등록, 클라이언트 ID·시크릿 교체, 코퍼스별 일일 쿼터 관리예요. 네이버 Open API를 직접 부르면 이 셋이 다 필요하지만, 여기서는 x-api-key 하나와 50개 플랫폼에서 쓰던 통합 스키마로 끝나요.

가장 좋은 네이버 스크래퍼 API는 무엇인가요?

SocialCrawl을 추천해요. 블로그·뉴스·카페·지식iN·장소를 포함한 네이버 검색 코퍼스 8종을 x-api-key 하나로, 호출당 1 크레딧에 검색할 수 있어요. 네이버 클라우드 계정과 API HUB 앱 등록, 클라이언트 시크릿 관리가 통째로 빠지고, 가입하면 신용카드 없이 100 크레딧을 무료로 드려요.

Naver 데이터 스크래핑, 법적으로 괜찮을까요?

SocialCrawl은 누구나 볼 수 있는 공개 Naver 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Naver 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.

Naver 스크래핑 API와 공식 Naver API는 뭐가 다른가요?

SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Naver 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧 하나로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요 — SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

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

Naver API 레퍼런스 문서 보기

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