섹션 1
마켓별 API 키 발급 (가장 먼저)
마켓에 상품을 등록·수정하거나 주문을 가져오려면 API 키가 필요한 경우가 많습니다. 프로그램에 넣기 전에, 사용 중인 마켓마다 아래 순서대로 키를 발급받으세요.
발급한 값은 설정 → 계정설정의 아이디키·시크릿키·업체코드에 입력합니다. (처음 해야 할 설정 참고)
한눈에 보기 — 프로그램 입력란 매핑
| 마켓 | 아이디키 | 시크릿키 | 업체코드 | 비고 |
|---|---|---|---|---|
| 스마트스토어 | 애플리케이션 ID | 애플리케이션 시크릿 | — | 네이버 커머스 API |
| 쿠팡 | Access Key | Secret Key | Vendor ID | Wing Open API |
| 11번가 | OPEN API KEY (32자) | — | — | Seller API |
| 옥션·G마켓 | 불필요 | 불필요 | — | 판매자 로그인만 |
1. 스마트스토어 — 네이버 커머스 API
필요 권한: 스마트스토어 통합매니저 (주문 API까지 쓰려면 주문 판매자 권한도 필요)
- 네이버 커머스 API 센터 접속 → 스마트스토어 계정으로 로그인
- 처음이면 계정 생성 → 「내 스마트스토어 전용 커머스 API」 선택 후 가입
- 애플리케이션 → 내 스토어 애플리케이션 → 애플리케이션 등록
- 애플리케이션 이름·설명 입력 → API 권한에서 상품·주문 관련 API를 모두 추가 → 등록
- 등록한 애플리케이션 상세에서 애플리케이션 ID(아이디키)와 애플리케이션 시크릿(시크릿키) 복사
- 상태가 활성인지 확인 후 프로그램 계정설정에 입력
스마트스토어센터의 「API관리」(대행사용)와 커머스 API 센터의 「내 스토어 애플리케이션」은 별개입니다. SmartSellUp은 커머스 API 센터에서 발급한 ID·시크릿을 사용합니다.
2. 쿠팡 — Wing Open API
필요 조건: 사업자 인증이 완료된 쿠팡 Wing 판매자 계정
- 쿠팡 Wing 로그인
- 우측 상단 판매자명 클릭 → 판매자정보 또는 추가판매정보
- 상단에서 업체코드(Vendor ID, A 또는 C로 시작) 확인 → 프로그램 업체코드에 입력
- 하단 API Key 발급받기 → 사용 목적 OPEN API 선택 → 약관 동의
- 자체개발(직접입력) 선택 → 업체명·URL(없으면 wing.coupang.com)·사용 PC 공인 IP 입력 (최대 10개)
- 발급된 Access Key(아이디키)·Secret Key(시크릿키)를 프로그램에 입력
최초 발급 후 실제 API 접근 권한이 반영되기까지 24시간 이상 걸릴 수 있습니다. 키는 약 180일마다 재발급이 필요합니다.
3. 11번가 — OPEN API (Seller API)
- 11번가 OPEN API 센터 → 판매자 아이디로 로그인
- 상단 서비스 등록·확인 → 이용 정보 입력 후 등록
- 11ST OPEN API KEY [등록] 또는 Seller API 정보 수정에서 IP 등 추가 정보 입력
- API 관리에서 [인증하기] 완료 → API KEY 상태가 승인 완료인지 확인
- 발급된 32자리 API KEY를 프로그램 아이디키에 입력 (시크릿키 불필요)
키 수정·승인 후 상품 전송이 안 되면 1시간 정도 기다린 뒤 다시 시도하세요. 국내·글로벌 계정은 API KEY가 각각 따로입니다.
4. 옥션·G마켓 (ESM PLUS)
상품 등록·동기화는 판매자 아이디·비밀번호만으로 가능합니다. API 키는 넣지 않아도 됩니다.
- 설정 → 계정설정에서 마켓·아이디·패스워드·스토어명·사업자만 등록
- 주문 수집 API는 현재 버전에서 미지원
5. (선택) 검색광고 API — 광고관리 탭
스마트스토어 쇼핑검색 광고를 SmartSellUp에서 관리할 때만 필요합니다. 커머스 API와 별도입니다.
- 네이버 검색광고 → API 이용관리에서 CUSTOMER_ID·액세스라이선스·비밀키 발급
- 설정 → 계정설정 → 해당 스마트스토어 → 검색광고 API 입력 → 연동 테스트
자세한 사용법은 광고관리 섹션을 보세요.
6. (선택) 네이버 쇼핑검색 OpenAPI — 자동카테고리
스마트스토어·쿠팡 자동카테고리 기능에 쓰입니다.
- 네이버 개발자센터 → 애플리케이션 등록 → 검색 API 사용
- Client ID·Client Secret을 설정 → 옵션설정(또는 기타설정)에 저장
7. (선택) 도매꾹 Open API
도매꾹 탭에서 상품 검색·저장할 때 필요합니다.
- 도매꾹 Open API에서 API Key 발급
- 설정 → 기타설정 → 도매꾹 API Key 입력
8. (선택) Google Gemini API — AI SEO · 동영상제작
상품명·태그·대표이미지 등 AI SEO 메이커와, 상품 숏폼 동영상제작(대본 생성)에 필요합니다. 마켓 API와 별도이며, 설정 → 기타설정에 입력합니다.
- Google AI Studio · API 키 페이지 접속 → Google 계정으로 로그인
- 좌측 메뉴 또는 상단에서 API 키 만들기 (영문 화면: Create API key) 클릭
- 프로젝트를 선택하거나 새 프로젝트를 만든 뒤 계속
- 생성된 API 키를 복사 (한 번만 전체가 보이는 경우가 많으니 바로 저장)
- SmartSellUp → 설정 → 기타설정 → AI 사용여부 체크 → Gemini API Key에 붙여넣기 → 저장
무료 이용 한도가 있으며, Google 정책에 따라 과금·호출 제한이 바뀔 수 있습니다. API 키는 타인에게 노출되지 않게 관리하세요. 같은 키를 여러 프로그램에서 동시에 쓰면 할당량(429) 오류가 나기 쉽습니다.
8-1. (선택) Typecast API — 동영상 TTS
동영상제작 탭에서 나레이션(TTS)을 만들 때 필요합니다. 설정 → 기타설정에 Typecast API 키를 입력합니다.
발급 후 확인
- 키 앞뒤 공백이 들어가지 않았는지 확인
- 쿠팡은 업체코드·Access Key·Secret Key 세 가지가 모두 맞아야 함
- 11번가는 키 길이 32자, 상태 승인 완료 확인
- 입력 후 계정설정에서 등록 → 상품 전송 또는 상품동기화로 연동 테스트