
네이버 광고 API 종류 정리: 검색광고, 성과형 디스플레이, 커머스는 어디까지 열려 있나
Docca 팀 | 2026-10-30 | 9분
네이버 광고 API 를 찾아보면 검색광고 API 문서, 성과형 디스플레이 광고 API 문서, 커머스API 문서가 모두 나와서 내 광고에 맞는 게 무엇인지 헷갈리기 쉬워요. 결론부터 말하면 광고주가 오늘 바로 키를 받아 쓸 수 있는 건 검색광고 API 하나예요. 성과형 디스플레이 광고(GFA) API 는 있긴 하지만 공식 파트너사만 신청할 수 있고 커머스API 는 스마트스토어의 상품과 주문을 다루는 API 예요.
이 글에서는 세 가지가 각각 무엇을 하고 어디서 발급받으며 누가 쓸 수 있는지를 네이버 공식 문서로 확인해 정리하고 그중 검색광고 API 로 하려던 일을 코드 없이 말로 물어보는 방법까지 이어서 보여 드릴게요. 모두 2026년 10월 27일에 공개 문서를 보고 확인한 내용이에요.
한눈에 보는 네이버 광고 API 세 가지
| API | 할 수 있는 일 | 어디서 발급 | 누가 쓸 수 있나 |
|---|---|---|---|
| 검색광고 API | 파워링크, 쇼핑검색, 파워컨텐츠, 브랜드검색, 플레이스 캠페인의 조회와 수정, 성과와 보고서, 키워드 검색량과 입찰가 추정 | 광고주센터 도구 → SA API 사용 관리 | 검색광고 계정이 있는 광고주와 권한을 위임받은 대행사 |
| 성과형 디스플레이 광고(GFA) API | 캠페인, 광고 그룹, 소재 관리와 과거·실시간·전환 성과 조회, 고객 파일 타겟 | 네이버 개발자센터에서 앱을 만든 뒤 GFA 대표 관리 계정의 API 관리에서 신청 | 베타 기간이라 공식 파트너사만 신청 가능 |
| 커머스API | 스마트스토어 상품 등록, 주문 조회와 처리 같은 스토어 운영 | 커머스API센터 가입 후 애플리케이션 등록 | 내 스토어는 판매자 본인, 여러 판매자에게 서비스하려면 커머스솔루션마켓 입점사나 API 대행사 |
쇼핑검색광고(쇼핑몰 상품형, 카탈로그형, 쇼핑 브랜드형)도 검색광고 API 안에 들어 있어서 파워링크와 같은 키로 함께 다뤄요.
검색광고 API 는 광고주가 바로 쓸 수 있는 유일한 광고 API
검색광고 API 는 네이버 광고주센터에서 키를 받으면 바로 쓸 수 있어요. 키는 광고 계정마다 하나씩 나오고 따로 심사하지 않아서 계정이 있다면 지금 발급받을 수 있어요.
요청마다 이 세 값으로 서명을 만들어 헤더에 붙이는데 서명 코드와 실제로 부딪히는 제약은 네이버 검색광고(파워링크) API, 이것 모르고 쓰면 분석이 틀어집니다에 따로 정리해 두었어요. 전체 명세는 네이버의 검색광고 API 공식 문서에 있어요.
이 API 하나로 다루는 캠페인 유형은 공식 검색광고 API FAQ에 정리돼 있어요.
| 캠페인 유형 | API 코드 | 광고그룹 유형 |
|---|---|---|
| 파워링크 | WEB_SITE | 파워링크 그룹 |
| 쇼핑검색 | SHOPPING | 쇼핑몰 상품형, 제품 카탈로그형, 쇼핑 브랜드형 |
| 파워컨텐츠 | POWER_CONTENTS | 파워컨텐츠 그룹 |
| 브랜드검색 | BRAND_SEARCH | 브랜드검색, 브랜드존 |
| 플레이스 | PLACE | 플레이스, 지역 소상공인 광고 |
캠페인 구조를 읽고 고치는 것 말고도 일별 성과(/stats), 검색어와 시간대 같은 보고서(/stat-reports), 연관 키워드와 월 검색량(/keywordstool), 순위별 입찰가 추정(/estimate)까지 같은 키로 불러요.
쇼핑검색광고는 검색광고 API 안에 있어요
쇼핑검색광고를 API 로 다루고 싶은 분들이 따로 쇼핑 광고 API 를 찾는 경우가 많은데 쇼핑검색은 검색광고 API 의 캠페인 유형 SHOPPING 이라서 파워링크와 같은 키, 같은 주소로 캠페인과 광고그룹, 소재, 성과를 받아요. 그룹 유형마다 연결하는 비즈채널이 정해져 있어서 상품형은 쇼핑몰(MALL), 카탈로그형은 카탈로그(CATALOG), 쇼핑 브랜드형은 브랜드스토어(BRAND_STORE) 채널을 써요.
다만 상품명, 카테고리, 가격, 대표 이미지는 쇼핑검색광고 성과에 크게 영향을 주지만 스마트스토어에 있는 정보라서 검색광고 API 로는 바꿀 수 없어요. 이건 아래에서 볼 커머스API 의 영역이에요.
성과형 디스플레이 광고(GFA) API 는 공식 파트너사만
GFA 에도 API 가 있어요. 네이버가 운영하는 성과형 디스플레이 광고 API 문서 첫 화면에는 "베타 테스트 중으로, 공식 파트너사인 경우에 한해 API 사용 신청 및 권한 부여가 가능합니다" 라고 적혀 있고 파트너사가 아니면 신청이 제한된다고 덧붙여 있어요. 그래서 광고주가 직접 키를 받아 쓰는 길은 지금 열려 있지 않아요.
파트너사라면 신청하는 순서는 이래요.
문서에는 테스트 기간 동안 일부 관리 계정에서만 신청할 수 있다는 단서도 붙어 있어요. 검색광고 API 가 계정별 키와 서명으로 인증하는 것과 달리 GFA API 는 네이버 로그인(OAuth) 토큰을 쓰기 때문에 검색광고 키로는 GFA 를 부를 수 없어요.
열려 있는 기능은 꽤 넓어요. 광고 계정과 관리 계정, 캠페인, 광고 그룹, 소재를 조회하고 고치며 과거 성과와 실시간 성과, 전환 성과를 받고 고객 파일로 만든 잠재고객 타겟도 다뤄요. 2026년 5월 27일에는 소재 생성과 이미지·동영상 업로드 API 가 추가됐고, 8월 26일에는 앞에서 말한 ADV쇼핑 캠페인 관리와 애셋 그룹 단위 성과 조회가 추가됐어요(변경 사항 안내).
기술 문의 창구도 파트너사 기준이에요. 2026년 1월 검색광고 API 저장소에 GFA API 문의 창구를 묻는 글이 올라오자 네이버 성과형 디스플레이 광고 운영자가 파트너사 지원 메일로 문의해 달라고 답했어요.
커머스API: 광고가 아니라 스마트스토어 운영용
"네이버 쇼핑 광고 API" 를 찾다가 커머스API 에 닿는 경우도 많은데 커머스API 소개를 보면 이 API 는 스마트스토어의 주요 기능이나 콘텐츠를 HTTP 로 부를 수 있게 공개한 API 예요. 상품을 등록하고 주문을 조회하고 클레임을 처리하는 것처럼 스토어를 운영하는 일이 중심이라서 광고 캠페인이나 입찰가, 광고 성과를 다루는 기능은 공개 문서에서 찾지 못했어요.
쓰려면 커머스API센터에 가입한 뒤 애플리케이션을 등록해 권한을 받아요. 판매자가 자기 스토어에 직접 연동할 때는 내스토어 애플리케이션을 쓰고 여러 판매자에게 서비스를 하려면 커머스솔루션마켓에 입점하거나 API 대행사가 돼야 해요. 2026년 4월 커머스API 담당자는 판매자에게 내스토어 애플리케이션 정보를 받아 대신 운영하는 식으로 서비스해서는 안 되고 API 대행사 신청은 국내 법인 사업자가 아니면 반려될 수 있다고 답했어요.
정리하면 쇼핑검색광고를 운영할 때 광고 쪽(입찰가, 매체, 제외 검색어, 성과)은 검색광고 API 로, 상품 정보 쪽(상품명, 가격, 이미지)은 커머스API 로 나뉘어요.
검색광고 API 로 하려던 일, 말로 물어보기
세 가지 중 광고주가 지금 쓸 수 있는 건 검색광고 API 인데 서명을 만들고 92일씩 나눠 받고 보고서 파일을 풀어야 해서 표 하나를 보려 해도 코드가 꽤 길어져요. Docca 에 검색광고 키를 한 번 넣어 두면 그 일을 서버가 대신 하고 Claude 나 ChatGPT 에 하고 싶은 일을 말로 물어보면 돼요.

https://api.usedocca.com/v1/mcpDocca 로 내 네이버 검색광고 지난 14일 성과를 캠페인 유형별로 나눠 보여 줘. 쇼핑검색 캠페인은 소재(상품)별로 비용과 전환을 정리하고, 비용만 쓰고 전환이 없는 상품은 따로 짚어 줘.파워링크와 쇼핑검색이 같은 API 에 있어서 한 번에 물어볼 수 있어요. 검색광고 API 로 많이 하는 일을 질문으로 바꾸면 이렇게 돼요.
| 하려던 일 (API) | 이렇게 물어보기 |
|---|---|
| 캠페인 구조 보기 (/ncc/campaigns) | "켜져 있는 캠페인과 광고그룹을 유형별로 정리하고 하루 예산도 같이 보여 줘" |
| 일별 성과 받기 (/stats) | "지난달 캠페인별 비용과 전환을 주 단위로 정리해 줘" |
| 검색어 보고서 (/stat-reports) | "쇼핑검색에서 지난 30일 비용만 쓰고 전환이 없는 검색어를 골라 줘" |
| 연관 키워드·검색량 (/keywordstool) | "'캠핑의자' 연관 키워드를 월 검색량 순으로 20개 보여 줘" |
| 순위별 입찰가 (/estimate) | "이 키워드로 모바일 3위에 오르려면 입찰가가 얼마야?" |
| 입찰가 바꾸기 (/ncc/keywords) | "전환 없는 키워드 입찰가를 20% 낮춰 줘" |
조회 질문은 계정을 읽기만 하고, 바꾸라고 말했을 때만 계정을 바꿔요. 한 번에 두 개 이상 바꿀 때는 바로 반영하지 않고 바꾸기 전과 후를 확인 창에 보여 준 뒤 사람이 승인해야 나가요.
자주 묻는 것
GFA 숫자도 검색광고 API 로 받을 수 있나요? 아니요, GFA 는 별도 API 이고 인증 방식도 달라서 검색광고 키로는 부를 수 없어요.
스마트스토어 매출과 광고비를 같이 보고 싶어요. 광고비는 검색광고 API 로, 주문과 매출은 커머스API 로 받아야 해서 두 API 를 따로 연동해야 해요. 광고 성과 쪽 전환이 0 으로만 나온다면 네이버 검색광고 전환수·전환매출이 API 에 안 나온다면, 전환추적부터를 먼저 확인해 보세요.


