API 가이드

애드픽 API를 활용하면 커미션 링크 생성, 제휴몰 조회, 상품 검색 등을 여러분의 서비스에 직접 연동할 수 있습니다.

빠른 시작 가이드

3단계로 API 연동을 시작해보세요

API 키 발급

API KEY 관리 페이지에서 API 키를 생성하세요. 최대 10개까지 생성할 수 있습니다.

→

API 테스트

API 테스트 페이지에서 발급받은 API 키로 실제 호출을 확인해보세요. 응답 형식과 동작을 미리 검증할 수 있습니다.

→

서비스 적용

테스트가 완료되면 블로그, 앱, 웹사이트 등 여러분의 서비스에 API를 연동하세요. 커미션 링크, 상품 검색, 성과 조회 등을 바로 활용할 수 있습니다.

기본 정보

Base URL: https://biz.adpick.co.kr/api/{apikey}/{function}?{params}

요청 방식: GET (모든 API는 GET 방식으로 호출합니다)

응답 형식: application/json

인코딩: UTF-8 (한글 파라미터는 UTF-8로 인코딩해주세요)

요청 제한: 분당 10회 (1분 후 자동 초기화)

CORS: 모든 도메인에서 호출 가능 (Access-Control-Allow-Origin: *)

인증 방식

API 키를 URL 경로에 직접 포함하는 방식입니다. 별도의 Authorization 헤더가 필요하지 않아 간편하게 사용할 수 있습니다.
API 키는 외부에 노출되지 않도록 서버 사이드에서 호출하는 것을 권장합니다.
다만, 정산 등 일부 기능 이용 시에는 Whitelist 적용이 필수입니다.

호출 예시 (cURL)

curl -X GET "https://biz.adpick.co.kr/api/YOUR_API_KEY/link?url=https://www.11st.co.kr/products/12345"

API 엔드포인트

제공되는 5가지 API를 활용해 커미션 링크 생성, 다이렉트 링크 이동, 제휴몰 조회, 상품 검색, 성과 데이터 조회 기능을 구현할 수 있습니다.

제휴몰의 상품 URL을 입력하면, 해당 상품에 대한 커미션 추적이 가능한 링크를 생성합니다. 이 링크를 통해 사용자가 상품을 구매하면 커미션이 자동으로 적립됩니다.

활용 예시: 블로그, 앱, 웹사이트에 상품을 소개할 때, 원본 URL 대신 커미션 링크를 사용하면 구매 전환에 대한 수익을 얻을 수 있습니다.

요청 URL

GET https://biz.adpick.co.kr/api/{apikey}/link?url={상품URL}

요청 파라미터

이름	타입	필수	설명
`url`	string	필수	제휴몰의 상품 URL (UTF-8 인코딩). 상품 상세페이지의 전체 URL을 입력하세요.
`p_data`	string(50)	선택	자체 전환 성과 추적을 위한 구분 코드 (성과 데이터 API에서 확인 가능)

응답 필드

필드명	타입	설명
`commissionlink`	string	생성된 커미션 추적 링크 URL
`cp_name`	string	제휴몰(쇼핑몰) 이름
`cp_code`	string	제휴몰 고유 코드
`cp_icon`	string	제휴몰 아이콘 이미지 URL
`commission_per`	string	커미션 비율 (예: "5.0"은 5%)
`product_name`	string	상품명
`product_price`	string	상품 가격 (원 단위, 예: "29,900원")
`product_img`	string	상품 이미지 URL

응답 예시

{
  "success": true,
  "message": "커미션 링크 생성 성공",
  "data": {
    "status": "success",
    "commissionlink": "",
    "cp_icon": "https://cdn.adpick.co.kr/icons/mall.png",
    "cp_name": "11번가",
    "cp_code": "11ST",
    "commission_per": "3.0",
    "product_name": "삼성 갤럭시 버즈3 프로",
    "product_price": "259,000원",
    "product_img": "https://cdn.example.com/product.jpg"
  }
}

이 API를 바로 테스트해보기 →

상품 URL을 전달하면 내부적으로 커미션 링크를 생성한 뒤, 사용자를 해당 페이지로 즉시 리다이렉트(이동)시킵니다. JSON 응답 없이 브라우저가 바로 커미션이 적용된 상품 페이지로 이동하므로, <a> 태그의 href나 버튼 클릭 시 URL로 바로 사용할 수 있습니다.

활용 예시: 블로그 글이나 웹페이지에 상품 링크를 넣을 때, 별도의 API 호출 코드 없이 이 URL을 바로 링크로 사용하면 됩니다. 사용자가 클릭하면 자동으로 커미션이 적용된 상태로 쇼핑몰 상품 페이지에 도착합니다.

호출 제한 없음: 다이렉트 커미션 링크는 다른 API와 달리 분당 호출 횟수 제한이 없습니다. HTML 링크로 직접 사용되는 특성상, 여러 사용자가 동시에 클릭해도 제한 없이 정상 동작합니다.

요청 URL

GET https://biz.adpick.co.kr/api/{apikey}/directlink?url={상품URL}

요청 파라미터

이름	타입	필수	설명
`url`	string	필수	제휴몰의 상품 URL (UTF-8 인코딩). 상품 상세페이지의 전체 URL을 입력하세요.
`p_data`	string(50)	선택	자체 전환 성과 추적을 위한 구분 코드 (성과 데이터 API에서 확인 가능)

응답 방식

✓

성공 시

JSON 응답 없이 HTTP 302 Redirect로 커미션이 적용된 상품 페이지로 바로 이동합니다.

실패 시

에러 메시지를 alert으로 표시하고 이전 페이지로 돌아갑니다. (API 키 오류, URL 오류 등)

사용 예시

HTML에서 링크로 바로 사용하는 예시입니다.

<!-- HTML 링크로 사용 -->
<a href="https://biz.adpick.co.kr/api/YOUR_API_KEY/directlink?url=https://www.11st.co.kr/products/12345">
  이 상품 보러가기
</a>

<!-- 버튼 클릭 시 이동 -->
<button onclick="location.href='https://biz.adpick.co.kr/api/YOUR_API_KEY/directlink?url=https://www.11st.co.kr/products/12345'">
  쇼핑몰로 이동
</button>

이 API를 바로 테스트해보기 →

현재 애드픽과 제휴 중인 쇼핑몰 전체 목록을 조회합니다. 각 쇼핑몰의 이름, 아이콘, 설명 정보와 함께 해당 쇼핑몰 홈으로 이동하는 커미션 링크도 포함됩니다.

활용 예시: 제휴몰 목록을 가져와 사용자에게 쇼핑몰 리스트를 보여주거나, 특정 쇼핑몰의 커미션 링크를 배너 등에 활용할 수 있습니다.

요청 URL

GET https://biz.adpick.co.kr/api/{apikey}/malls

요청 파라미터

이름	타입	필수	설명
`p_data`	string(50)	선택	자체 전환 성과 추적을 위한 구분 코드 (성과 데이터 API에서 확인 가능)

응답 필드 (배열)

data 필드에 쇼핑몰 객체의 배열이 반환됩니다.

필드명	타입	설명
`cp_code`	string	쇼핑몰 고유 코드
`name`	string	쇼핑몰 이름
`icon`	string	쇼핑몰 아이콘 이미지 URL
`title`	string	쇼핑몰 간략 설명
`commissionlink`	string	해당 쇼핑몰 홈으로 이동하는 커미션 링크

응답 예시

{
  "success": true,
  "message": "제휴몰 목록을 가져왔습니다.",
  "data": [
    {
      "cp_code": "11ST",
      "name": "11번가",
      "icon": "https://cdn.adpick.co.kr/icons/11st.png",
      "title": "대한민국 대표 오픈마켓",
      "commissionlink": ""
    },
    {
      "cp_code": "COUPANG",
      "name": "쿠팡",
      "icon": "https://cdn.adpick.co.kr/icons/coupang.png",
      "title": "로켓배송의 시작",
      "commissionlink": ""
    }
  ]
}

이 API를 바로 테스트해보기 →

키워드로 여러 제휴몰의 상품을 한번에 검색합니다. 검색 결과에는 상품명, 가격, 이미지는 물론 커미션 링크가 이미 포함되어 있어, 별도로 link API를 호출할 필요가 없습니다. 최대 20개까지 결과를 반환합니다.

활용 예시: 상품 비교 페이지, 가격 알림 서비스, 쇼핑 추천 콘텐츠 등에서 검색 결과를 바로 활용할 수 있습니다.

요청 URL

GET https://biz.adpick.co.kr/api/{apikey}/search?q={검색어}&limit={개수}

요청 파라미터

이름	타입	필수	설명
`q`	string	필수	상품 검색어 (UTF-8 인코딩). 예: "노트북", "무선이어폰" 등
`limit`	number	선택	검색 결과 개수. 1~20 사이 값 (기본값: 10, 최대: 20)
`p_data`	string(50)	선택	자체 전환 성과 추적을 위한 구분 코드 (성과 데이터 API에서 확인 가능)

응답 필드 (배열)

data 필드에 상품 객체의 배열이 반환됩니다.

필드명	타입	설명
`title`	string	상품명
`price`	string	상품 가격 (원 단위, 예: "29,900원")
`photo`	string	상품 이미지 URL
`cp_code`	string	제휴몰 고유 코드
`cp_name`	string	제휴몰 이름
`cp_icon`	string	제휴몰 아이콘 이미지 URL
`commissionlink`	string	해당 상품의 커미션 링크 (바로 사용 가능)

응답 예시

{
  "success": true,
  "message": "노트북 검색 결과를 가져왔습니다.",
  "data": [
    {
      "title": "삼성 갤럭시북4 프로 NT940XGQ-A51A",
      "price": "1,590,000원",
      "photo": "https://cdn.example.com/product1.jpg",
      "cp_code": "11ST",
      "cp_name": "11번가",
      "cp_icon": "https://cdn.adpick.co.kr/icons/11st.png",
      "commissionlink": ""
    },
    {
      "title": "LG 그램 17 17ZD90S-GX56K",
      "price": "1,890,000원",
      "photo": "https://cdn.example.com/product2.jpg",
      "cp_code": "COUPANG",
      "cp_name": "쿠팡",
      "cp_icon": "https://cdn.adpick.co.kr/icons/coupang.png",
      "commissionlink": ""
    }
  ]
}

이 API를 바로 테스트해보기 →

커미션 링크를 통해 발생한 전환(구매) 성과 데이터를 조회합니다. 날짜, 주문번호, 상태, 구분코드 등 다양한 필터로 성과 기록을 검색할 수 있으며, 합계 정보(매출, 커미션, 수량)도 함께 제공됩니다.

활용 예시: 자체 대시보드에서 일별/기간별 성과를 집계하거나, 주문번호로 개별 전환 상태를 확인할 수 있습니다. link API에서 p_data를 설정했다면, 해당 구분코드로 필터링하여 캠페인별 성과를 분석할 수 있습니다.

조회 기간 제한: sdate~edate 기간 간격은 최대 60일까지 가능합니다.
IP Whitelist 필수: API 호출을 위해서는 허용된 IP가 whitelist에 등록되어 있어야 합니다.
제외 제휴몰: 제휴몰 정책상 리워드 제공이 불가한 쿠팡 등 일부 제휴몰의 성과데이터는 API형태로 제공되지 않습니다.

요청 URL

GET https://biz.adpick.co.kr/api/{apikey}/conversion?sdate={시작일}&edate={종료일}

요청 파라미터

이름	타입	필수	설명
`sdate`	string	선택	조회 시작일 (YYYYMMDD 형식, 예: 20260201). 기본값: 오늘
`edate`	string	선택	조회 종료일 (YYYYMMDD 형식, 예: 20260206). 기본값: 오늘
`cdate`	string	선택	전환일 기준 조회 (YYYYMMDD). 설정 시 sdate/edate 무시, 전환일 기준으로 정렬됩니다.
`page`	number	선택	페이지 번호 (1부터 시작). 기본값: 1
`limit`	number	선택	한 페이지당 결과 개수 (최대 200). 기본값: 50
`p_data`	string	선택	구분코드. 링크 생성 시 설정한 p_data 값으로 필터링
`o_cd`	string	선택	주문번호로 필터링
`status`	string	선택	상태 필터. `정상` 또는 `취소` (예: status=정상). 기본값: 전체
`link_id`	string	선택	링크코드로 필터링
`cp_code`	string	선택	제휴몰 코드로 필터링. malls API에서 조회한 제휴몰 코드를 사용합니다.

응답 필드

data 필드에 합계(summary)와 목록(list)이 포함됩니다.

summary (합계)

필드명	타입	설명
`total_qty`	number	전체 수량
`total_sales`	number	전체 매출액 (원)
`total_commission`	number	전체 커미션 (원)
`normal_sales`	number	정상 매출액
`normal_commission`	number	정상 커미션
`cancel_sales`	number	취소 매출액
`cancel_commission`	number	취소 커미션
`pending_commission`	number	대기중 커미션 (확정 전)
`confirmed_commission`	number	확정 커미션

list (목록 배열)

필드명	타입	설명
`idx`	number	고유 번호
`cp_code`	string	제휴몰 코드
`o_cd`	string	주문번호
`regdate`	string	구매일시
`confirm_date`	string	전환(확정)일시
`p_nm`	string	상품명
`qty`	number	수량
`sales`	number	매출액 (원)
`commission`	number	커미션 (원)
`commission_rate`	number	커미션율 (%)
`status`	string	상태 (정상/확인중/확정/취소)
`p_data`	string	구분코드 (링크 생성 시 설정한 p_data)
`link_id`	string	링크코드

응답 예시

{
  "success": true,
  "message": "성과 데이터를 조회했습니다.",
  "data": {
    "total_count": 125,
    "page": 1,
    "limit": 50,
    "summary": {
      "total_qty": 150,
      "total_sales": 4500000,
      "total_commission": 135000,
      "normal_qty": 140,
      "normal_sales": 4200000,
      "normal_commission": 126000,
      "cancel_qty": 10,
      "cancel_sales": 300000,
      "cancel_commission": 9000,
      "pending_commission": 80000,
      "confirmed_commission": 46000
    },
    "list_count": 50,
    "list": [
      {
        "idx": 12345,
        "cp_code": "COUPANG",
        "o_cd": "2026020600001",
        "regdate": "2026-02-06 14:30:00",
        "confirm_date": null,
        "p_nm": "삼성 갤럭시 버즈3 프로",
        "qty": 1,
        "sales": 259000,
        "commission": 7770,
        "commission_rate": 3.0,
        "status": "정상",
        "p_data": "blog_campaign_01",
        "link_id": "abc123"
      }
    ]
  }
}

호출 예시

# 오늘 성과 조회 (기본)
curl "https://biz.adpick.co.kr/api/YOUR_API_KEY/conversion"

# 기간 지정 조회
curl "https://biz.adpick.co.kr/api/YOUR_API_KEY/conversion?sdate=20260201&edate=20260206"

# 전환일 기준 조회
curl "https://biz.adpick.co.kr/api/YOUR_API_KEY/conversion?cdate=20260205"

# 정상 건만 + 구분코드 필터
curl "https://biz.adpick.co.kr/api/YOUR_API_KEY/conversion?sdate=20260201&edate=20260206&status=정상&p_data=blog_01"

# 주문번호로 조회
curl "https://biz.adpick.co.kr/api/YOUR_API_KEY/conversion?sdate=20260201&edate=20260206&o_cd=2026020600001"

이 API를 바로 테스트해보기 →

에러 처리

API 호출 시 오류가 발생하면 아래 형식의 JSON 응답이 반환됩니다. HTTP 상태 코드와 에러 메시지를 확인하여 적절히 처리해주세요.

에러 응답 형식

{
  "status": "error",
  "code": 400,
  "error": "에러 메시지 내용"
}

성공 시에는 "success": true가 반환되므로, 응답의 success 필드로 성공 여부를 판단하세요.

HTTP 코드	의미	해결 방법
400	잘못된 요청	필수 파라미터가 누락되었거나, 파라미터 형식이 올바르지 않습니다. URL이나 검색어를 다시 확인해주세요.
401	인증 실패	API 키가 유효하지 않습니다. API KEY 관리 페이지에서 키를 확인하거나 새로 발급해주세요.
403	접근 제한	분당 요청 횟수(10회)를 초과했습니다. 1분 후에 자동으로 초기화되니 잠시 기다려주세요.
404	존재하지 않는 기능	요청한 API 엔드포인트가 존재하지 않습니다. URL 경로의 function 이름을 다시 확인해주세요 (link, directlink, malls, search, conversion).
501	서버 오류	서버 내부 오류가 발생했습니다. 문제가 지속되면 고객센터로 문의해주세요.

회원별 성과 추적 & 활용

API를 통해 커미션 링크에 구분코드(p_data)를 포함시켜 사용자별 성과를 추적하고, 이벤트나 선물 제공에 활용할 수 있습니다.

링크 발급

회원별 고유 구분코드(p_data)를 포함한 커미션 링크를 API로 생성하여 회원에게 제공합니다.

회원의 구매

회원이 발급받은 커미션 링크를 통해 쇼핑몰에서 상품을 구매하면, p_data와 함께 구매 성과가 자동으로 기록됩니다.

성과 조회

성과데이터 API에서 p_data로 필터링하여 회원별 실적(매출, 커미션, 수량)을 정확하게 조회합니다.

활용

조회된 성과 데이터를 기반으로 회원 대상 이벤트를 진행하거나 선물을 제공하는 등 다양하게 활용할 수 있습니다.

예시 — 회원 user_123에게 커미션 링크 발급 후 성과 조회

링크 생성 (p_data에 회원 ID 지정)

GET /api/{key}/link?url={상품URL}&p_data=user_123

해당 회원의 성과 조회

GET /api/{key}/conversion?p_data=user_123

API 가이드

빠른 시작 가이드

API 키 발급

API 테스트

서비스 적용

기본 정보

API 엔드포인트

요청 URL

요청 파라미터

응답 필드

응답 예시

요청 URL

요청 파라미터

응답 방식

사용 예시

요청 URL

요청 파라미터

응답 필드 (배열)

응답 예시

요청 URL

요청 파라미터

응답 필드 (배열)

응답 예시

요청 URL

요청 파라미터

응답 필드

응답 예시

호출 예시

에러 처리

회원별 성과 추적 & 활용

링크 발급

회원의 구매

성과 조회

활용

자주 묻는 질문

ADPICK BIZ 상담