API 가이드

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

빠른 시작 가이드

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

1

API 키 발급

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

2

API 테스트

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

3

서비스 적용

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

기본 정보

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

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

응답 형식: application/json

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

요청 제한: API 기능별 rate limit 확인 필요

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 상품 정보 이용 안내

Q. API 상품 정보는 어떤 목적으로 제공되나요?

애드픽 API가 반환하는 상품 정보는 제휴 마케팅에서 커미션 링크를 생성하고 노출하기 위한 참고 정보입니다.

Q. 제공되는 상품 정보의 범위는 어디까지인가요?

제공 항목은 본 가이드의 각 API 응답 필드에 한정됩니다. 재고, 옵션, 배송 조건, 판매 상태 등 쇼핑몰 상품 정보의 전체는 포함되지 않습니다.

Q. 가격은 실제 판매가와 동일한가요?

가격은 참고값입니다. 실제 판매가 및 할인가와 다를 수 있으며, 회사는 가격의 정확성과 최신성을 보증하지 않습니다.

Q. API 이용에 별도 요금이나 호출 제한이 있나요?

API 이용에 대한 별도 요금은 없습니다. 안정적인 운영과 공정한 이용을 위하여 API별로 호출 횟수를 제한합니다. 제한은 API마다 다르므로, 본 가이드에서 각 API에 표시된 Rate Limit을 확인해 주세요. 호출 제한은 운영상 필요에 따라 조정될 수 있습니다.

Q. 상품 이미지와 상품 정보를 저장하거나 가공할 수 있나요?

상품 이미지와 상품 정보에 관한 권리는 해당 쇼핑몰 또는 판매자에게 있습니다. 회사는 그 권리의 저장, 가공, 재이용을 허락하지 않습니다. 상품 정보는 이용자가 자신의 서비스에서 제휴 판매를 구성할 때 참고하도록 제공되며, 이를 저장하거나 가공하여 이용하는 경우의 적법성과 책임은 이용자에게 있습니다. 회사는 그러한 이용을 허락하지 않으며, 그로 인하여 발생하는 법적 분쟁에 대하여 책임을 지지 않습니다.

Q. 호출량을 늘리거나 상품 데이터를 일괄로 받을 수 있나요?

호출량 확대, 연동 방식 변경 등 운영 조건의 조정이 필요한 경우, 예상 규모와 이용 목적을 제출하시면 회사가 검토합니다. 상품 데이터의 일괄 제공과 API 이외의 데이터 이용은 별도의 협의가 필요합니다.

Q. 이용 조건은 무엇을 기준으로 하나요?

회원 가입 시 동의한 이용약관, 본 가이드의 호출 제한 및 본 안내를 기준으로 합니다.