네이버 데이터랩 API, 검색어 트렌드 시계열 받는 법

네이버 데이터랩 api는 검색 횟수가 아니라, 조회 구간 최댓값을 100으로 둔 ratio 시계열을 POST와 JSON으로 줘요. Client ID로 검색어 트렌드를 호출하고, 검색이 0인 날을 0으로 채운 파이썬 예제, 쇼핑인사이트와의 차이까지 적어 두었어요. 쓰는 건 Python 3.10+, requests, 네이버 오픈API예요. 2026-07-31 이후 신규 키는 NAVER API HUB에서 받고, 그 이전 키는 개발자센터가 2027-06-30까지 살아 있어요.

네이버 데이터랩 API를 호출하기 전에 준비할 것

여러분은 계정, 키, 파이썬만 있으면 돼요. 배경 설명은 건너뛰어요.

• 네이버 계정. 회사면 단체 회원으로 신청하는 게 나아요. 등록한 아이디가 관리자가 돼요.
• 신규 키 (2026-07-31 이후): NCP 계정으로 NAVER API HUB에서 Search Trend와 Shopping Insight를 따로 신청해요. 헤더는 X-NCP-APIGW-API-KEY-ID와 X-NCP-APIGW-API-KEY예요. (공지 32530)
• 기존 키 (2026-07-31 이전 개발자센터 신청분): X-Naver-Client-Id와 X-Naver-Client-Secret. 2027-06-30 이후에는 막혀요. 키 두 종류는 호스트끼리 호환되지 않아요.
• Python 3.10+, requests(또는 httpx), pandas. pip install urllib이나 pip install json은 하지 마세요. 표준 라이브러리예요.
• 키는 환경 변수에 두세요. 코드에 하드코드하지 마세요.
• HTTP JSON이랑 .env만 읽을 줄 알면 돼요. 광고 계정은 필요 없어요. 비로그인 오픈 API예요. (오픈API 종류)

호스트와 헤더는 API HUB 개요와 개발자센터 API 목록을 따랐어요. 쿼터 숫자는 아래에서 개발자센터와 HUB를 나눠 적을게요.

네이버 오픈API에서 데이터랩 Client ID는 어디서 받나요?

신규 키는 NAVER API HUB, 2026-07-31 전에 받은 키는 개발자센터예요. 2026년 여름부터 네이버 오픈API 발급 창구가 갈려요. 레거시 curl만 복사하면, 2026-07-31 이후 신규 신청자는 키가 안 나와요.

공지 32530 일정은 이래요. 2026-06-25 HUB 출시 → 2026-07-31 개발자센터에서 Search API · Search Trend · Shopping Insight 신규 신청 차단 → 2027-06-30 개발자센터 종료. 그 전에 받아 둔 키는 종료일까지 개발자센터 호스트에서 쓸 수 있고, 이후에는 기존 키도 막혀요.

검색어 트렌드와 쇼핑인사이트는 사용 API 목록의 별개 항목이에요. 하나만 켜면 401이나 403이 나요. (쇼핑인사이트 문서)

호출은 HTTPS만 돼요. HTTP는 403이에요. (HUB 개요)

POST에는 Content-Type: application/json이 필요해요. 공식 레퍼런스 HTTP 덤프에 가끔 보이는 application/x-www-form-urlencoded는 틀린 값이에요. 아래 예제는 JSON을 쓰니까, JSON으로 맞추면 돼요.

쇼핑·책·전문자료 검색 API는 HUB 이관 대상이 아니에요. 유예 없이 2026-07-31 종료, 대체 없음. (공지 32530, 공지 32564) 데이터랩이랑 다른 제품이니 헤더를 섞지 마세요.

헤더만 대조하면 이래요.

# HUB (신규 키)
X-NCP-APIGW-API-KEY-ID: 키값
X-NCP-APIGW-API-KEY: 시크릿

# 레거시 (2026-07-31 이전 신청분)
X-Naver-Client-Id: 키값
X-Naver-Client-Secret: 시크릿

개발자센터 API 목록 페이지는 아직도 레거시 경로를 싣고 있어요. 신규 키는 HUB만 가능하다는 공지와 목록이 어긋나니, 2026-07-31 이후 신청이면 HUB 호스트와 HUB 헤더를 쓰세요.

네이버 검색어 트렌드 API는 어떻게 호출하나요?

네이버 검색어 트렌드는 POST + JSON이에요. 검색 횟수가 아니라 구간 안 상대 지수고, 필수 필드는 startDate, endDate, timeUnit, keywordGroups예요. (검색어 트렌드 레퍼런스)

그룹당 검색어 한도는 문서가 갈려요. 레퍼런스는 20, 사용 가이드 FAQ는 5예요. 개요/FAQ와 레퍼런스가 갈리면 레퍼런스를 따르는 쪽이 맞아요.

ratio는 횟수가 아니에요. 같은 검색어라도 기간을 바꾸면 100이 붙는 구간이 바뀌어요.

아래는 일단 돌아가는 파이썬이에요. 키는 환경 변수, 타임아웃 10초, 429는 2–3회 재시도, 403/400은 원인별로 갈라요. 공식 샘플의 print("Error Code:" + rescode)는 rescode가 int라 TypeError가 나요. 따라 하지 마세요.

import os
import time
import requests

CLIENT_ID = os.environ["NAVER_CLIENT_ID"]
CLIENT_SECRET = os.environ["NAVER_CLIENT_SECRET"]

# HUB(신규 키). 레거시면 아래 주석 호스트와 X-Naver-* 헤더를 쓰세요.
HOST = "https://naverapihub.apigw.ntruss.com/search-trend/v1/search"
# HOST = "https://openapi.naver.com/v1/datalab/search"

headers = {
    "Content-Type": "application/json",
    "X-NCP-APIGW-API-KEY-ID": CLIENT_ID,
    "X-NCP-APIGW-API-KEY": CLIENT_SECRET,
    # "X-Naver-Client-Id": CLIENT_ID,
    # "X-Naver-Client-Secret": CLIENT_SECRET,
}

body = {
    "startDate": "2026-08-19",
    "endDate": "2026-09-15",
    "timeUnit": "date",
    "keywordGroups": [
        {"groupName": "캠핑", "keywords": ["캠핑", "Camping", "캠핑용품"]},
    ],
}


def fetch_trend(url, headers, body, attempts=3):
    delay = 1.0
    for _ in range(attempts):
        res = requests.post(url, json=body, headers=headers, timeout=10)
        if res.status_code == 429:
            retry_after = res.headers.get("Retry-After")
            wait = float(retry_after) if retry_after else delay
            time.sleep(wait)
            delay *= 2
            continue
        if res.status_code == 403:
            raise SystemExit(
                "403: 앱에서 검색어 트렌드 권한을 켜 주세요. HTTP가 아니라 HTTPS인지도 확인하세요."
            )
        if res.status_code == 400:
            raise SystemExit(
                "400: JSON, keywordGroups 5개 제한, 날짜 형식(YYYY-MM-DD)을 확인하세요. "
                + res.text[:300]
            )
        res.raise_for_status()
        return res.json()
    raise SystemExit("429가 반복됐어요. 쿼터나 RPS를 확인하고 잠시 뒤에 다시 호출하세요.")


payload = fetch_trend(HOST, headers, body)
print(payload)

응답 모양은 이래요. 공식 HUB 예시도 1–6월 창에서 5·6월 점을 빼 두고, SocialCrawl 카탈로그는 측정이 안 된 키워드에 점이 없다고 적어요. 아래 JSON의 2026-08-21 구멍은 그 동작을 보여 주는 예시예요.

{
  "startDate": "2026-08-19",
  "endDate": "2026-09-15",
  "timeUnit": "date",
  "results": [
    {
      "title": "캠핑",
      "keywords": ["캠핑", "Camping", "캠핑용품"],
      "data": [
        { "period": "2026-08-19", "ratio": 42.12345 },
        { "period": "2026-08-20", "ratio": 38.01234 },
        { "period": "2026-08-22", "ratio": 100 }
      ]
    }
  ]
}

429일 때 헤더를 읽고 기다리는 법은 트위터 API 초과 글이랑 같은 뼈대예요. Retry-After가 있으면 그 초를 존중하고, 없으면 1초 → 2초 → 4초로 늘리면 돼요.

검색이 0인 날은 data 배열에서 빠져요

검색이 안 잡힌 구간은 값이 0으로 오는 게 아니라 키가 없어요. 차트에 그대로 그리면 전날이 다음날로 이어져, 없는 검색이 있는 것처럼 보여요. 네이버 검색어 트렌드를 일 단위(timeUnit=date)로 받을 때 구멍이 잘 보여요. week나 month도 공식 예시처럼 버킷이 빠질 수 있어요.

pd.date_range로 달력을 다시 깔고, 없는 날 ratio를 0으로 채운 뒤 CSV로 저장하면 돼요. 월별 평균은 그 다음에 구하면 돼요. 차트 라이브러리는 안 넣었어요. CSV가 먼저예요.

import pandas as pd

series = pd.DataFrame(payload["results"][0]["data"])
series["period"] = pd.to_datetime(series["period"])
idx = pd.date_range("2026-08-19", "2026-09-15", freq="D")
filled = (
    series.set_index("period")
    .reindex(idx)
    .assign(ratio=lambda df: df["ratio"].fillna(0))
)
monthly = filled["ratio"].resample("ME").mean()
filled.to_csv("camping-trend.csv")
monthly.to_csv("camping-trend-monthly.csv")

쿼터는 계층이 달라요. 숫자를 한 줄로 합치지 마세요.

• 개발자센터: 통합 검색어 트렌드 레퍼런스에 하루 1,000회, 클라이언트 아이디별 합산이라고 적혀 있어요. 쇼핑인사이트 문서도 하루 1,000회예요.
• HUB FAQ: 검색어 트렌드 월 50,000건, 쇼핑인사이트 월 50,000건. 한도는 API별로 따로 세요. Rate limit은 키당 최대 50 RPS, Data Lab 플랫폼 500 RPS. 초과 시 429, 1초 뒤 회복. 월 한도 소진 시 호출 차단, 50/80/100% 메일. (사용 가이드)

NCP 개요의 429 설명은 “하루 허용량”이고, 같은 제품 FAQ는 Data Lab 한도를 월로 적어요. RPS와 월 쿼터를 섞어 읽지 마세요. 검색어 트렌드 1,000회/일을 HUB 숫자인 것처럼 단정하지 마세요.

네이버 키워드 검색량을 API로 절대값으로 받을 수 있나요?

없어요. ratio는 해당 요청 구간에서 가장 큰 값을 100으로 둔 상대 지수예요. 네이버 키워드 검색량을 '월 1만 회' 같은 절댓값으로 주는 API가 데이터랩에는 없고, 데이터랩 웹에도 절댓값은 없어요.

한 요청 안의 주제어끼리는 같은 스케일이라서 비교가 돼요. 기간을 바꾼 요청끼리 80과 80을 비교하면 안 돼요. (상대값 설명)

잘못된 비교는 호출을 두 번 나눠 놓고 숫자를 붙이는 거예요.

{
  "startDate": "2026-01-01",
  "endDate": "2026-03-31",
  "timeUnit": "month",
  "keywordGroups": [{ "groupName": "캠핑", "keywords": ["캠핑"] }]
}

이 요청의 3월 ratio 80과, 기간을 4–6월로 바꾼 다음 요청의 80은 같은 80이 아니에요. 100의 분모가 달라요.

올바른 비교는 한 바디에 그룹을 나란히 넣는 쪽이에요.

{
  "startDate": "2026-08-19",
  "endDate": "2026-09-15",
  "timeUnit": "date",
  "keywordGroups": [
    { "groupName": "캠핑", "keywords": ["캠핑"] },
    { "groupName": "차박", "keywords": ["차박"] }
  ]
}

구글 트렌드 API도 관심도는 상대값이에요. 네이버 쪽 검색 점유율 숫자로 환산하지는 마세요. 그 숫자는 이 글의 출처에 없어요.

네이버 검색광고 API, 네이버 키워드 도구는 광고 제품이에요. 네이버 키워드 검색량을 그쪽 월간검색량과 더하면 스케일이 섞여요. 데이터랩이랑 키도 달라요.

네이버 데이터랩 사용법이랑 API 호출은 뭐가 다른가요?

웹은 차트·엑셀이고 API는 JSON ratio 시계열이에요. 네이버 데이터랩 사용법으로 많이 찾는 화면은 datalab.naver.com이에요. 차트, 엑셀 다운로드, 급상승 검색어가 거기 있어요. 로그인 웹이고, 사람이 기간을 고르고 파일을 받는 흐름이에요.

API 호출은 주제어 최대 5그룹, 기기·성별·연령 필터, JSON 시계열이에요. 대시보드나 배치 잡에 넣을 때 쓰는 쪽이에요. 웹 사용법이든 API든 절댓값은 없어요. 둘 다 ratio예요.

급상승 검색어는 UI 기능이에요. 이 글의 검색어 트렌드 API 스펙에 급상승 엔드포인트는 없어요. 스펙에 없으니 있다고 가정하지 마세요.

웹에서 한 번 보고, 같은 주제어를 API 바디에 넣으면 숫자가 같은 스케일로 나오는지만 확인하면 돼요. 엑셀 컬럼을 JSON 필드에 1:1로 대응시킨다고 생각하면 어긋나요. 웹은 화면용 반올림이 있고, API는 소수 ratio를 그대로 줘요.

쇼핑인사이트 API랑 검색어 트렌드는 뭐가 다른가요?

검색어 트렌드는 통합검색 주제어의 검색 추이예요. 쇼핑인사이트는 쇼핑 영역·네이버쇼핑 클릭 추이예요. 같은 데이터랩 가족이지만 경로, 한도, 연령 코드, 이력 바닥이 달라요. (쇼핑인사이트 분야별)

사용 가이드 FAQ는 Data Lab 조회 기간을 통째로 “2016년 1월 1일 이후”라고 적어요. 레퍼런스와 개발자센터 쇼핑 문서는 쇼핑 바닥을 2017-08-01로 못 박아요. 쇼핑 조회 기간을 2016으로 보내면 거절되니, 쇼핑은 2017-08-01을 쓰세요.

분야 코드 목록 API는 없어요. 네이버쇼핑 URL의 cat_id를 읽어요.

shop_url = "https://naverapihub.apigw.ntruss.com/shopping/v1/categories"
# 레거시: https://openapi.naver.com/v1/datalab/shopping/categories
shop_body = {
    "startDate": "2026-08-19",
    "endDate": "2026-09-15",
    "timeUnit": "date",
    "category": [
        {"name": "패션의류", "param": ["50000000"]},
        {"name": "화장품미용", "param": ["50000002"]},
    ],
}
shop = requests.post(shop_url, json=shop_body, headers=headers, timeout=10)
shop.raise_for_status()

검색어 트렌드 스크립트를 여기 붙여 넣지 마세요. 경로와 바디 키(keywordGroups vs category)가 달라요.

네이버 검색 API랑 데이터랩 API는 같은 건가요?

아니요. 네이버 검색 API는 GET + 쿼리스트링이에요. 블로그·뉴스 같은 문서를 받아요. 데이터랩은 POST + JSON 시계열이에요. 같은 네이버 오픈API라도 메서드와 인증 헤더 키가 갈릴 수 있어요. (오픈API 종류)

네이버 검색 API 예시를 데이터랩 호출에 복사하면 400이 나요. GET에 JSON 바디를 붙이거나, 데이터랩 POST에 쿼리스트링만 넣으면 둘 다 실패해요.

오류 스키마는 계층마다 달라요. 게이트웨이는 error 객체 안에 errorCode, message, details가 있어요. 검색 API는 errorCode와 errorMessage, 트렌드·쇼핑은 errMsg와 errId예요. (HUB 개요) 한 파서로 세 갈래를 받으면 필드가 비어요.

검색 API와 데이터랩을 한 파일에 섞을 때도 함정이 있어요. 검색은 GET, 데이터랩은 POST예요. aiohttp 코루틴 안에 동기 requests를 넣으면 이벤트 루프가 막혀요. 비동기면 둘 다 비동기로, 동기면 둘 다 동기로 두세요.

트렌드 키워드로 실제 네이버 게시물까지 이으려면요?

검색어 트렌드 ratio 다음에 같은 키워드로 블로그·뉴스·카페 검색을 한 번 더 치면 돼요. ratio만 받으면 키워드 문자열만 손에 있어요. 그 문자열로 블로그·뉴스·카페 글을 받으려면 검색 코퍼스로 한 번 더 호출해야 해요. SocialCrawl API는 공식 데이터랩 POST를 서버에서 GET으로 감싸 줘요. 같은 키로 게시물 목록까지 이을 수 있어요.

열려 있는 경로만 적을게요. 크레딧은 호출당이에요. (네이버 엔드포인트 카탈로그, sns api 가격)

• GET /v1/naver/search-trend — 5cr. keywords CSV, 한 그룹으로 합산된 시계열 하나. 용어 비교는 호출을 나누세요. 공식 API는 그룹 5개지만, 이 엔드포인트는 그룹 1개예요. time_unit: date / week / month. ages: 1–11. 바닥 2016-01-01. keywords 상한 20.
• GET /v1/naver/shopping-insight/category — 5cr. category_code 최대 3. breakdown을 device / gender / age로 주면 네이버 쪽 8경로를 접어요. 바닥 2017-08-01. ages: 10/20/30/40/50/60.
• GET /v1/naver/shopping-insight/keyword — 5cr. 분야 1 + 키워드 최대 5, 키워드별 별도 시계열 (search-trend와 행동이 달라요).
• 검색 코퍼스 8개 + errata/adult — 1cr: /v1/naver/blog/search, /v1/naver/news/search, /v1/naver/cafearticle/search, /v1/naver/kin/search, /v1/naver/webkr/search, /v1/naver/encyc/search, /v1/naver/image/search, /v1/naver/local/search, 그리고 /v1/naver/errata, /v1/naver/adult.
• GET /v1/naver/brief — 10cr. news/blog/cafearticle/kin/webkr를 나란히 쳐요.

트렌드 ratio는 시계열 숫자라서, 게시물 스키마와 필드가 달라요. 키워드 문자열을 blog/search · news/search · cafearticle/search · brief에 넘기면, 통합 스키마로 실제 게시물이 와요. 쇼핑·책·전문자료 검색은 네이버가 2026-07-31에 종료해서, shop 코퍼스는 400이에요.

import os
import requests

trend = requests.get(
    "https://www.socialcrawl.dev/v1/naver/search-trend",
    params={"keywords": "캠핑,Camping,캠핑용품", "time_unit": "date"},
    headers={"x-api-key": os.environ["SOCIALCRAWL_API_KEY"]},
    timeout=10,
)
trend.raise_for_status()

posts = requests.get(
    "https://www.socialcrawl.dev/v1/naver/blog/search",
    params={"query": "캠핑"},
    headers={"x-api-key": os.environ["SOCIALCRAWL_API_KEY"]},
    timeout=10,
)
posts.raise_for_status()

인증은 x-api-key예요. 공식 데이터랩 POST를 직접 치기 싫으면 이 GET이 그 다음 단계예요. 네이버 엔드포인트 전체는 네이버 플랫폼에 있고, 여러 SNS를 한 스키마로 받는 맥락은 통합 소셜 데이터 API 글에 있어요.

자주 묻는 질문

네이버 데이터랩 API는 무료인가요?

개발자센터는 문서상 하루 호출 한도(검색어 트렌드 레퍼런스 1,000회) 안에서 비로그인 오픈 API예요. HUB는 한시 무료고, 검색어 트렌드·쇼핑인사이트 각 월 5만 건이에요. 이후 유료 전환은 사전 공지예요. 광고 계정은 필요 없어요. (HUB FAQ)

네이버 데이터랩 API를 파이썬으로 호출하려면요?

requests.post에 JSON 바디와 Content-Type: application/json을 붙이면 돼요. 키는 환경 변수에서 읽으세요. 위의 파이썬 예제를 그대로 쓰면 되고, 공식 urllib 샘플의 Error Code: int 연결은 따라 하지 마세요.

검색어 트렌드 ratio는 실제 검색량인가요?

아니요. 조회 구간에서 가장 큰 값을 100으로 둔 상대 지수예요. 서로 다른 요청의 ratio는 비교 대상이 아니에요. 한 요청 안의 주제어끼리만 같은 스케일이에요. (검색어 트렌드 레퍼런스)

Client ID랑 Client Secret은 어디에 넣나요?

헤더에 넣어요. 레거시는 X-Naver-Client-Id / X-Naver-Client-Secret, HUB는 X-NCP-APIGW-API-KEY-ID / X-NCP-APIGW-API-KEY예요. 쿼리스트링이나 JSON 바디에 넣지 마세요. 호스트와 키 종류를 섞지 마세요.

네이버 데이터랩 API 쿼터가 초과되면 어떻게 되나요?

HTTP 429가 나와요. HUB는 월 한도 소진 시 호출을 막고, 50/80/100%에서 메일을 보내요. RPS 초과는 1초 뒤 회복해요. 잠시 기다렸다가 다시 호출하면 돼요. (HUB FAQ)

쇼핑인사이트 API랑 검색어 트렌드 API는 같은 건가요?

아니요. 검색 추이와 쇼핑 클릭 추이예요. 엔드포인트, ages 코드, 이력 바닥(2016-01-01 vs 2017-08-01), 한 요청 한도(5그룹 vs 3분야)가 달라요. (쇼핑인사이트)

공식 오픈API 말고 검색어 트렌드를 받는 다른 경로가 있나요?

SocialCrawl GET /v1/naver/search-trend(5cr)가 공식 POST를 서버에서 GET으로 감싸 줘요. 그룹은 1개만 열려요. 같은 키로 brief나 blog/search에 키워드를 넘기면 게시물까지 이을 수 있어요.