쿠팡파트너스 API는 링크 생성 같은 파트너스 기능을 개발자가 프로그램으로 쓰도록 만든 무료 Open API입니다. 이 글은 2026-10-26에 파트너스 API 가이드와 이용약관을 열어 확인한 이용 조건, 키 발급, 제공 기능, 약관의 제한을 정리했습니다. 호출 제한의 구체 수치는 화면에 항목만 있고 값을 확인하지 못해 미확인으로 두었으며, 이 글에는 예제 코드나 실제 키를 싣지 않았습니다.
이용 조건
- API 가이드는 파트너스 API가 최종 승인된 회원에게만 제공된다고 밝힙니다.
- 최종 승인 전에 필요하면 파트너스 ID와 광고를 게재할 영역과 광고 형태를 파트너스 메일로 보내 검토받을 수 있다고 안내합니다.
- 이용 가이드는 API 활용이 필수가 아니며 링크, 위젯, 배너만으로도 활동이 가능하다고 적고 있습니다.
- API는 웹이나 앱 개발자를 위한 도구로 소개됩니다.
최종 승인의 조건은 승인 글에서 다룹니다. 승인 전에 메일로 요청했을 때의 처리 기간은 미확인입니다.
키 발급과 보관
- 파트너스 상단 메뉴의 Tools에서 파트너스 API 항목으로 들어갑니다.
- 생성 버튼을 누르면 액세스 키와 시크릿 키가 곧바로 제공됩니다.
- 요청 헤더의 인증 값에 HMAC 서명을 만들어 함께 보냅니다.
서명은 요청 시각, 요청 방식, 주소 경로, 조회 조건을 이어 붙인 문자열에 시크릿 키로 HMAC-SHA256 값을 만드는 방식이라고 개발 문서의 예시 코드가 보여 줍니다. 호출 주소는 API 전용 게이트웨이를 쓰며, 딥링크 호출의 응답에는 원본 주소와 변환된 단축 주소가 한 쌍으로 담깁니다.
가이드는 키가 노출되지 않도록 유의하라고 하며, 분실이나 유출 시 파트너스에 문의하라고 안내합니다. 서명 만료, 서명 형식 오류, 인증되지 않은 요청 같은 대표 오류 메시지도 문서에 나열되어 있습니다.
제공 기능
| 기능 | 내용 |
|---|---|
| 상품 API | 쿠팡 상품 정보와 골드박스 상품 목록 등을 제공한다고 이용 가이드가 설명 |
| 딥링크 API | 쿠팡 페이지 주소를 파트너스 주소로 변환 |
| 리포팅 API | 일별 클릭과 실적 정보 제공 |
API 문서 화면에는 상품 API, 딥링크 API, 오류 코드, 호출 제한 항목이 구분되어 있습니다. 개발 문서 사이트는 별도로 운영됩니다.
약관과 호출 제한
- API 이용 약관은 이용자가 승인 없이 API나 데이터를 복제, 저장, 전송하는 것을 제한한다고 적고 있습니다.
- 시스템에 과부하를 주거나 업무를 방해하면 이용을 제한하거나 정지할 수 있습니다.
- 인증 키는 이용자에게 부여된 고유 값이며, 위반 시 사전 통지 없이 키와 이용이 중지될 수 있습니다.
- 운영정책은 자동화된 클릭 생성과 정책 위반 프로그램 사용을 이용제한 사유로 정하고 있습니다. 클릭 자동 생성은 API와 무관하게 금지됩니다.
- 호출 제한의 구체 수치: 문서에 메뉴만 있고 값을 확인하지 못해 미확인입니다.
API로 만든 글이나 자동화 도구가 플랫폼 정책에 어긋나지 않는지는 이용자가 직접 확인해야 합니다.
자주 묻는 질문
누구나 API를 쓸 수 있나요?
가이드에 최종 승인된 회원에게 제공된다고 적혀 있습니다. 승인 전 사용은 메일 검토를 거치도록 안내합니다.
API 이용에 비용이 드나요?
이용 가이드는 무료로 제공되는 Open API라고 소개합니다.
호출은 하루 몇 번까지 되나요?
호출 제한 항목이 있으나 수치를 확인하지 못해 미확인입니다.
키가 유출되면 어떻게 하나요?
분실이나 유출 시 파트너스에 직접 문의하라고 가이드가 안내합니다.