# 쿠팡 상품 조회 쿠팡 상품 주소 또는 상품번호로 상품명·정가·판매가·할인율·평점·리뷰 수·재고·판매자·옵션·카테고리·이미지를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/coupang_product 응답 필드 - `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. - `data.product_id` (string): 쿠팡 상품번호 - `data.url` (string): 상품 주소 - `data.title` (string): 상품명 - `data.rating` (number): 평점 - `data.reviews` (integer): 리뷰 수 - `data.initial_price` (string): 할인 전 가격 - `data.final_price` (string): 판매가 - `data.discount_rate` (integer): 할인율(%) - `data.currency` (string): 통화 - `data.seller_name` (string): 판매자명 null 허용. - `data.seller_rating` (number): 판매자 평점 null 허용. - `data.seller_reviews` (integer): 판매자 리뷰 수 null 허용. - `data.is_in_stock` (boolean): 재고 여부 - `data.images` (array): 이미지 주소 - `data.main_image` (string): 대표 이미지 주소 - `data.categories` (array): 카테고리(name·url) - `data.categories[].name` (string): 아래 하위 항목을 확인하세요. - `data.categories[].url` (string): 아래 하위 항목을 확인하세요. - `data.variations` (array): 옵션 구성 - `data.variations[].name` (string): 아래 하위 항목을 확인하세요. - `data.variations[].variations` (array): 아래 하위 항목을 확인하세요. - `data.shipping_details` (array): 배송 유형 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): 차감된 포인트. 실패한 응답은 0 - `api.pl_id` (integer): API 결제 로그 ID - `api.ms` (integer): API 응답 시간(밀리초) ## API 요청: POST /rest/coupang_product ### 입력 - `url` (string, 조건부): 쿠팡 상품 주소 (/vp/products/ 형식, url 또는 product_id 중 하나 필수) - `product_id` (string, 조건부): 쿠팡 상품번호 (숫자) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "product_id": { "type": "string", "description": "쿠팡 상품번호" }, "url": { "type": "string", "description": "상품 주소" }, "title": { "type": "string", "description": "상품명" }, "rating": { "type": "number", "description": "평점" }, "reviews": { "type": "integer", "description": "리뷰 수" }, "initial_price": { "type": "string", "description": "할인 전 가격" }, "final_price": { "type": "string", "description": "판매가" }, "discount_rate": { "type": "integer", "description": "할인율(%)" }, "currency": { "type": "string", "description": "통화" }, "seller_name": { "nullable": true, "type": "string", "description": "판매자명" }, "seller_rating": { "nullable": true, "type": "number", "description": "판매자 평점" }, "seller_reviews": { "nullable": true, "type": "integer", "description": "판매자 리뷰 수" }, "is_in_stock": { "type": "boolean", "description": "재고 여부" }, "images": { "type": "array", "items": { "type": "string" }, "description": "이미지 주소" }, "main_image": { "type": "string", "description": "대표 이미지 주소" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" } } }, "description": "카테고리(name·url)" }, "variations": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "variations": { "type": "array", "items": { "type": "string" } } } }, "description": "옵션 구성" }, "shipping_details": { "type": "array", "items": { "type": "string" }, "description": "배송 유형" } }, "description": "조회 데이터. 실패하면 error 에 안내 문구가 담깁니다." }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "차감된 포인트. 실패한 응답은 0" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" }, "ms": { "type": "integer", "description": "API 응답 시간(밀리초)" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "product_id": "8314992021", "url": "https://www.coupang.com/vp/products/8314992021", "title": "한돈 대패삼겹살 (냉동), 300g, 1개", "rating": 4.6, "reviews": 880, "initial_price": "3,900원", "final_price": "2,370원", "discount_rate": 39, "currency": "KRW", "seller_name": null, "seller_rating": null, "seller_reviews": null, "is_in_stock": true, "images": [ "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/retail/images/..." ], "main_image": "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/retail/images/...", "categories": [ { "name": "축산/계란", "url": "https://www.coupang.com/np/categories/492731" } ], "variations": [ { "name": "중량 × 수량", "variations": [ "300g × 1개", "300g × 2개" ] } ], "shipping_details": [ "ROCKET" ] }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 25400 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/coupang_product' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'url=https://www.coupang.com/vp/products/8314992021' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("url", "https://www.coupang.com/vp/products/8314992021"); const response = await fetch("https://apick.app/rest/coupang_product", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("url", (None, "https://www.coupang.com/vp/products/8314992021")), ] response = requests.request("POST", "https://apick.app/rest/coupang_product", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'https://www.coupang.com/vp/products/8314992021', ]; $curl = curl_init('https://apick.app/rest/coupang_product'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 Method URL POST https://apick.app/rest/coupang_product 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 공개 상품 페이지 정보만 제공합니다. 보통 25~40초가 걸립니다. 최대 100초까지 기다립니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value url 응답 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. product_id String 쿠팡 상품번호 url String 상품 주소 title String 상품명 rating Number 평점 reviews Integer 리뷰 수 initial_price String 할인 전 가격 final_price String 판매가 discount_rate Integer 할인율(%) currency String 통화 seller_name String 판매자명 seller_rating Number 판매자 평점 seller_reviews Integer 판매자 리뷰 수 is_in_stock Boolean 재고 여부 images Array 이미지 주소 main_image String 대표 이미지 주소 categories Array 카테고리(name·url) variations Array 옵션 구성 shipping_details Array 배송 유형 api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "product_id": "8314992021", "url": "https://www.coupang.com/vp/products/8314992021", "title": "한돈 대패삼겹살 (냉동), 300g, 1개", "rating": 4.6, "reviews": 880, "initial_price": "3,900원", "final_price": "2,370원", "discount_rate": 39, "currency": "KRW", "seller_name": null, "seller_rating": null, "seller_reviews": null, "is_in_stock": true, "images": [ "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/retail/images/..." ], "main_image": "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/retail/images/...", "categories": [ { "name": "축산/계란", "url": "https://www.coupang.com/np/categories/492731" } ], "variations": [ { "name": "중량 × 수량", "variations": ["300g × 1개", "300g × 2개"] } ], "shipping_details": [ "ROCKET" ] }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 25400 } }