쿠팡파트너스 API 키 발급받는 법 (2026) — 발급 조건, 메뉴 위치, 키로 할 수 있는 것, 등록한 뒤 달라지는 것

쿠팡파트너스를 하다 보면 "API 키를 등록하면 링크가 자동으로 바뀐다"는 말을 듣게 된다. 그런데 파트너스 사이트에서 API 메뉴를 찾아 들어가면 발급 버튼이 안 눌리거나, Access Key와 Secret Key라는 낯선 두 값이 나오는데 어디에 어떻게 쓰는지 설명이 없다. 이 글은 쿠팡 파트너스 공식 이용 가이드 기준으로 API 키가 언제 발급되는지, 어느 메뉴에 있는지, 키로 무엇을 할 수 있는지를 정리하고, 그 키를 유유피 같은 도구에 등록하면 실제로 달라지는 것과 등록 전 반드시 함께 챙길 두 가지를 적는다.

읽기 전에: 발급 조건과 API 구성은 쿠팡 파트너스 공식 이용 가이드(2025-02 판, 2026-09 확인)를 근거로 한다. 메뉴 명칭은 파트너스 사이트가 개편되면 달라질 수 있다. 이 글은 쿠팡 링크 자동 변환 기능을 만드는 유유피(UUP) 팀이 쓴다.

1. API 키는 최종 승인 뒤에만 나온다

가이드가 가장 먼저 못 박는 조건이다. STEP 3 최종승인 페이지에 이렇게 적혀 있다 — "최종 승인이 완료되어야 ① 쿠팡 파트너스 활동에 대한 정산을 받으실 수 있으며, ② 파트너스 API 이용이 가능해요."

그러니까 가입 직후에는 API 메뉴가 있어도 키를 쓸 수 없다. 최종 승인의 흐름은 이렇다.

승인 과정과 반려 사유는 쿠팡파트너스 승인받는 법에 따로 정리했다. 승인 전이라면 이 글의 나머지는 "승인되면 할 일"로 읽어 두고, 지금은 파트너스 사이트에서 만든 간편링크를 직접 쓰면 된다(링크 만드는 법 — 세 가지 경로).

2. 메뉴 위치와 키의 생김새

파트너스 사이트에 로그인해 파트너스 API 메뉴로 들어간다(이용 가이드에서는 "링크 및 배너 생성법 — 파트너스 API" 항목으로 소개된다). 승인된 계정에서는 여기서 키를 발급받을 수 있고, 발급되면 두 값이 나온다.

• Access Key — 내 계정을 식별하는 값
• Secret Key — 요청에 서명하는 비밀값

둘은 한 쌍이고, 도구에 등록할 때도 둘 다 넣는다. Secret Key는 비밀번호와 같은 성격이라 캡처·공유·게시글 첨부를 하지 않는다. 복사할 때 앞뒤 공백이 딸려 오면 등록이 "키 확인 실패"로 떨어지므로 값만 정확히 붙여 넣는다.

가이드가 강조하는 것 하나 — "파트너스 API 활용은 필수 사항이 아닙니다! 파트너스 링크/위젯/배너로도 충분히 파트너스 활동이 가능합니다." 즉 API 키는 자동화를 원하는 사람의 선택지이지 활동 조건이 아니다.

3. 키로 할 수 있는 것 — API 세 종류

가이드는 파트너스 API를 세 갈래로 소개한다.

인스타그램 운영자에게 실질적으로 쓸모 있는 것은 딥 링크 API다. 상품 페이지 주소를 넣으면 내 수수료가 귀속되는 간편링크가 나온다 — 파트너스 사이트에서 손으로 하던 "링크 생성"을 프로그램이 대신하는 것이다. 상품 API는 상품 검색·목록을 도구 안에서 하게 해 주고, 리포팅 API는 리포트 화면의 숫자를 내려받는 용도다(리포트 자체는 리포트 보는 법에서 정리했다).

직접 개발하지 않는다면 이 API를 부르는 것은 도구의 몫이다. 회원이 하는 일은 키를 도구에 등록하는 것뿐이다.

4. 유유피에 등록하면 달라지는 것

유유피 대시보드의 쿠팡 파트너스 메뉴에서 API 키 등록을 누르고 Access Key·Secret Key를 넣은 뒤 저장하고 상태 확인을 누른다. 키는 암호화해 저장하고 화면에 다시 표시하지 않는다. 등록은 베이직(₩5,500/월) 이상 플랜에서 할 수 있다.

저장하면 유유피가 키의 유효성을 확인해 상태를 표시한다.

연결됨이 되면 달라지는 것은 세 가지다.

1. 일반 쿠팡 상품 주소를 상품에 넣고 저장하면 간편링크로 자동 변환된다. 파트너스 사이트를 열어 링크를 만들고 복사해 오는 단계가 사라진다.
2. 상품 편집 화면에 "제휴 링크로 변환" 버튼이 생긴다. 누르면 주소 칸 자체가 변환된 간편링크로 바뀐다 — 화면의 주소와 방문자에게 열리는 주소가 하나여야 하기 때문에 두 번째 주소를 따로 보여주지 않는다.
3. 쿠팡 상품 검색을 편집 화면 안에서 할 수 있다(사용자당 시간당 8회). 검색어 상한은 쿠팡 기준 50자라 상품명 전문을 넣으면 화면이 낱말 경계에서 줄여 넣고 그 사실을 알린다.

변환이 실패하면 원본 주소를 제휴 링크인 척 보여주지 않고 실패 사유와 함께 원본을 보존한다. 흔한 실패는 판매가 끝난 예전 상품 페이지 주소다 — 이 경우 쿠팡에서 다시 검색해 지금 판매 중인 페이지 주소로 시도하거나, 실패 안내의 상품 검색 버튼으로 바로 찾는다.

정직하게 적어 둘 한계 둘. 첫째, 유유피의 자동 변환은 링크에 SubID(채널ID)를 붙이지 않는다. 파트너스 리포트의 채널ID로 유유피 유입을 구분할 수는 없고, 출처는 유유피의 상품별 클릭·DM 퍼널 통계에서 읽는다. 둘째, 자동 변환은 저장 시점에 일어나므로 이미 저장돼 있던 옛 상품의 주소는 저절로 바뀌지 않는다 — 편집 화면에서 "제휴 링크로 변환"을 누른다.

5. 등록 전 반드시 함께 챙길 두 가지

유유피의 키 등록 화면에는 "승인 준비 체크리스트"가 함께 뜬다. 키만 넣고 끝내면 나중에 승인 반려나 지급 보류로 돌아온다.

1. 운영하는 모든 유유피 페이지 주소를 파트너스 활동 페이지로 등록한다. 파트너스 링크가 실제로 걸리는 곳이 링크페이지이므로, 그 주소가 활동 페이지에 없으면 "활동 페이지 미등록"이 반려 사유가 된다. 인스타 프로필도 함께 등록한다.
2. 대가성 문구가 제목 또는 첫 부분 가까이에 보이게 한 뒤 각 페이지의 화면을 캡처해 둔다. 권장 문장과 넣는 자리는 대가성 문구 글에 있고, 유유피 링크페이지의 공지바에 넣으면 상단 고정으로 첫 부분 조건을 맞추기 쉽다.

자주 묻는 질문

승인 전인데 API 메뉴가 보여요. 키를 만들면 되나요?

메뉴가 보여도 API 이용은 최종 승인 뒤에 열린다(가이드 STEP 3). 승인 전에는 파트너스 사이트에서 만든 간편링크를 유유피 상품의 주소 칸에 그대로 붙여 넣으면 된다 — 무료 플랜에서도 링크는 걸린다.

키를 다른 사람에게 알려줬어요 / 캡처가 올라갔어요

Secret Key가 노출되면 다른 사람이 내 계정 이름으로 API를 부를 수 있다. 파트너스 사이트의 API 메뉴에서 키를 새로 발급하고, 유유피에서는 API 키 교체로 새 키를 저장한다 — 새 키를 저장하면 기존 키는 더 쓰이지 않는다.

자동 변환 링크와 파트너스 사이트에서 만든 링크는 수수료가 다른가요?

같은 계정의 간편링크이므로 귀속은 같다. 다만 SubID를 쓰던 사람이라면 자동 변환 링크에는 SubID가 없다는 점만 다르다.

함께 보기

• 쿠팡파트너스 × 인스타그램 — 댓글에서 구매까지 자동화하는 법
• 쿠팡파트너스 승인받는 법 — 가입 절차, 최종 승인 기준, 승인 전에 할 수 있는 것
• 쿠팡파트너스 링크 만드는 법 — 파트너스 사이트·쿠팡 앱·자동 변환, 세 가지 경로

키를 등록해 저장하는 순간 간편링크가 되는 흐름은 무료로 시작에서 계정을 만든 뒤 쿠팡 파트너스 메뉴에서 열린다. 플랜별 차이는 요금제에 있다.